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BAG OF TRICKS 

A Super Disk Utility by the Authors of Beneath Apple DOS 

$39.95 



If you find BENEATH APPLE DOS useful, you should also find BAG OF TRICKS an important 
help in examining and patching up your diskettes. 

BAG OF TRICKS is a package of four machine language subroutines which go far beyond the 
example programs in Appendix A of this book. User friendly and well documented, this disk 
utility package is undoubtedly the best one available for the Apple II, especially at the low price 
of $39.95 

The four programs and their functions are: 

1. TRAX dumps and examines a raw track, either 1 3-sector or 16-sector, displays the internal 
Apple diskette formatting information, and flags exceptions to standard formats. 

2. I NIT will reformat one or more tracks on diskette, while attempting to preserve any data on 
them. Both 13-sector and 16-sector formats are supported. 

3. ZAP provides the basic capability to read, display, and update diskette sectors. More than 
50 commands are available to assist the user in locating, comparing, and changing the data 
on the diskette. Printer support, too. You won't believe how many useful options ZAP has. 

4. FIXC AT automates the process of recovering a damaged catalog track. The diskette can be 
searched for track sector lists, then the user can assign a name to files found by FIXCA 
and restore them to the catalog. Entire catalogs may be restored in this way. 

If you have ever had a disk crash, you know what a good disk utility is worth. Beginners will 
appreciate the "hand-holding" tutorials that will assist him in repairing his damaged diskettes, 
and the experienced user will appreciate how fast and easily he can perform analysis and 
repairs. 

BAG OF TRICKS requires a 48K Apple II or Apple II Plus. 
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CHAPTER 1 

INTRODUCTION 



Beneath Apple DOS is intended to serve as a companion to 
Apple's DOS Manual, providing additional information for the 
advanced programmer or the novice Apple user who wants to 
know more about the structure of diskettes. It is not the 
intent of this manual to replace the documentation provided 
by Apple Computer Inc. Although, for the sake of 
continuity, some of the material covered in the Apple manual 
is also covered here, it will be assumed that the reader is 
reasonably familiar with the contents of the DOS Manual. 
Since all chapters presented here may not be of use to each 
Apple owner, each has been written to stand on its own. 
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There were several reasons for writing Beneath Apple DOS: 

To show direct assembly language access to DOS. 

To help you to fix clobbered diskettes. 

To correct errors and omissions in the Apple documentation. 

To allow you to customize DOS to fit your needs. 

To provide complete information on diskette formatting. 
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When Apple Computer Inc. introduced its Disk Operatinq 
System (DOS) version 3 in 1978 to support the new DISK II 
drive, very little documentation was provided. Later, when 
DOS 3.2 was released, a 178 page instructional and reference 
manual became available covering the use of DOS from BASIC 
in depth and even touched upon some of the internal workings 
of DOS. With the advent of DOS 3.3, the old 3.2 manual was 
updated but the body of information in it remained 
essentially intact. Beyond these Apple manuals, there have 
been no significant additions to the documentation on DOS, 
apart from a few articles in APPLE user group magazines and 
newsletters. This manual takes up where the Disk Operating 
System Manual leaves off. 

Throughout this manual, discussion centers primarily on DOS 
version 3.3. The reasons for this are that 3.3 was the most 
recent release of DOS at the time of this writing and that 
it differs less from DOS 3.2 than one would imagine. 
Wherever there is a major difference between the various DOS 
releases in a given topic, each release will be covered. 

In addition to the DOS dependent information provided, many 
of the discussions also apply to other operating systems on 
the Apple II and Apple III. For example, disk formatting at 
the track and sector level is, for the most part, the same. 
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CHAPTER 2 

THE EVOLUTION OF DOS 
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Since its introduction, Apple DOS has gone through three 
major versions. All of these versions look very much the 
same on the surface. All commands supported by DOS 3.3 are 
also supported in 3.2 and 3.1. The need for additional 
versions has been more to fix errors in DOS and to make 
minor enhancements than to provide additional 
functionality. Only DOS 3.3 has offered any major 
improvement in function; an increase in the number of 
sectors that will fit on a track from 13 to 16. 

DOS 3 - 29 June 1978 
DOS 3.1 - 20 July 1978 

The first release of DOS was apparently a victim of a rush 
at Apple to introduce the DISK II. As such, it had a number 
of bugs. With the movement towards the APPLE II PLUS and the 
introduction of the AUTOSTART ROM, a new release was 
needed . 
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DOS 3.2 - 16 February 1979 

Although DOS 3.2 embodied more changes from its predecessor 
than any other release of DOS, 90% of the basic structure of 
DOS 3.1 was retained. The major differences between DOS 3.1 
and 3.2 and later versions of DOS are listed below: 

- NOMON C,I,0 is the initial default under DOS 3.2. MON 
C,I,0 was the default under DOS 3.1. 

- Input prompts (>,],*) are echoed when MON is in effect, 
not under MON I as was the case under 3.1. 

- When a DOS command was entered from the keyboard, DOS 
executed it and then passed a blank followed by a carriage 
return to BASIC under 3.1. Under 3.2 only a carriage 
return is passed. 

- Under 3.2, certain commands may not be entered from the 
keyboard but may only be used within a BASIC program 
(READ, WRITE, POSITION, OPEN, APPEND) . 

- Under 3.2, when LOADing an APPLESOFT program, DOS 
automatically converts from APPLESOFT ROM format to 
APPLESOFT RAM format if the RAM version of BASIC is in use 
and vice versa. 

- DOS 3.1 could not read lower case characters from a text 
file; DOS 3.2 can. 

2-1 




2l 



DOS 3 
1978 



DO'S 1.2 
1979 



DOS 3.3 
I960 



THE EVOLUTION OF APPLE DOS. 

- Some DOS commands are allowed to create a new file, others 
will not. Under DOS 3.1, any reference to a file that 
didn't exist, caused it to be created. This forced DOS 3.1 
to then delete it if a new file was not desired. (LOAD XYZ 
under 3.1 if XYZ did not exist, created XYZ, deleted XYZ, 
and then printed the file not found error message.) Under 
3.2, OPEN is allowed to create a file if one does not 
exist, but LOAD may not. 

- Under 3.1, exiting to the monitor required that the 
monitor status register location ($48) be set to zero 
before reentering DOS. Under DOS 3.2 this is no longer 
necessary. 

- The Read/Write-Track/Sector (RWTS) section of DOS disables 
interrupts while it is executing. Under 3.1, RWTS could be 
interrupted by a peripheral while writing to a disk, 
destroying the disk. 

- The default for the B (byte offset) keyword is under 
3.2. 

- DOS was reassembled for 3.2 causing most of its 
interesting locations and routines to move slightly. This 
played havoc with user programs and utilities which had 
DOS addresses built into them. 

- Additional file types (beyond T, I, A, and B) are defined 
within DOS 3.2, although no commands yet support them. The 
new types are S, R, a new A, and a new B. R has 
subsequently been used by the DOS TOOLKIT for relocatable 
object module assembler files. At present, no other use 
is made of these extra file types. 

- Support was added under 3.2 for the AUTOSTART ROM. 

- All files open when a disk full condition occurs are 
closed by DOS 3.2. 

- As with each new release of DOS, several new programs were 
added to the master diskette for 3.2. Among these was 
UPDATE 3.2, a replacement for MASTER CREATE, the utility 
for creating master diskettes. UPDATE 3.2 converts a slave 
into a master and allows the HELLO file to be renamed. 

DOS 3.2.1 - 31 July 1979 

DOS 3.2.1 was essentially a "maintenance release" of DOS 
3.2. Minor patches were made to RWTS and the COPY program 
to correct a timing problem when a dual drive copy was done. 
Additional delays were added following a switch between 
drives . 

2-2 
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DOS 3.3 - 25 August 1980 

Introduced in mid 1980 as a hardware/software upgrade from 
DOS 3.2.1, the DOS 3.3 package includes new bootstrap and 
state ROM chips for the disk controller card which provide 
the capability to format, read, and write a diskette with 16 
sectors. (These ROMs are the same ones used with the 
LANGUAGE SYSTEM.) This improvement represents almost a 25% 
increase in available disk space over the old 13 sector 
format. Also included in the 3.3 package is an updated 
version of the DOS manual, a BASICS diskette (for 13 sector 
boots), and a master diskette. Although the RWTS portion of 
DOS was almost totally rewritten, the rest of DOS was not 
reassembled and only received a few patches: 

- The initial DOS bootstrap loader was moved to $800 under 
3.3. It was at $300 under 3.2. In addition, as stored on 
the diskette (track sector 0) it is nibbilized in the 
same way as all other sectors under 3.3. 

- A bug in APPEND which caused it to position improperly if 
the file was a multiple of 256 bytes long was fixed under 
3.3. 

- A VERIFY command is internally executed after every SAVE 
or BSAVE under 3.3. 

- All 4 bytes are used in the Volume Table Of Contents 

(VTOC) free sector bit map when keeping track of free 
sectors. This allows DOS to handle up to 32 sectors per 
track. Of course, RWTS will only handle 16 sectors due to 
hardware limitations. 

- If a LANGUAGE CARD is present, DOS stores a zero on it at 
$E000 during bootstrap to force the HELLO program on the 
master diskette to reload BASIC. 

- DOS is read into memory from the top down (backwards) 
under 3.3 rather than the bottom up. Its image is still 
stored in the same order on the diskette (tracks 0, 1, and 
2) , however . 

- Additional programs added to the master diskette under 3.3 
include FID, a generalized file utility which allows 
individual files or groups of files to be copied, MUFFIN, 
a conversion copy routine to allow 3.2 files to be moved 
to 16 sector 3.3 diskettes, BOOT 13, a program which will 
boot a 13 sector diskette, and a new COPY program which 
will also support single drive copies. 

- Under 3.2, speed differences in some drives prevented 
their use together with the DOS COPY program. Because the 
COPY program was rewritten under 3.3, that restriction no 
longer applies. 
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DOS 3.3 - 1 January 1983 

This "maintenance release" of DOS was introduced with the 
Apple lie computer. It contains a few minor patches and no 
additional function. 

- A patch was introduced in DOS 3.3 to fix a bug in APPEND 
processing. This patch also had bugs. Additional patches 
were added to (hopefully) correct this problem. 

- An error in the POSITION calculation for large files is 
corrected in this release. 

- A few instructions were added to properly support the 80 
column display on the Apple lie. 

- The system master diskette contains some different files. 
Notably, a fast loader for the language card and all of 
the example programs have been moved to a separate 
diskette . 
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CHAPTER 3 

DISKETTE FORMATTING 






Apple Computer's excellent manual on the Disk Operating 
System (DOS) provides only very basic information about how 
diskettes are formatted. This chapter will explain in detail 
how information is structured on a diskette. The first 
section will contain a brief introduction to the hardware, 
and may be skipped by those already familiar with the DOS 
manual . 
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It should be pointed out, for the sake of accuracy, that the 
disk arm can position itself over 70 "phases". To'move the 
arm past one track to the next, two phases of the stepper 
motor, which moves the arm, must be cycled. This implies 
that data might be stored on 70 tracks, rather than 35. 
Unfortunately, the resolution of the read/write head and the 
accuracy of the stepper motor are such, that attempts to use 
these phantom "half" tracks create so much cross-talk that 
data is lost or overwritten. Although the standard DOS uses 
only even phases, some protected disks use odd phases or 
combinations of the two, provided that no two tracks are 
closer than two phases from one another. See APPENDIX B for 
more information on protection schemes. 

A sector is a subdivision of a track. It is the smallest 
unit of "updatable" data on the diskette. DOS generally 
reads or writes data a sector at a time. This is to avoid 
using a large chunk of memory as a buffer to read or write 
an entire track. Apple DOS has used two different track 
formats — one divides the track into 13 sectors, the other 
into 16 sectors. The sectoring does not use the index hole, 
provided on most diskettes, to locate the first sector of 
the track. The implication is that the software must be 
able to locate any given track and sector with no help from 
the hardware. This scheme, known as "soft sectoring", takes 
a little more space for storage but allows flexibility, as 
evidenced by the change from 13 sectors to the present 16 
sectors per track. Figure 3.2 categorizes the amount of 
data stored on a diskette under both 13 and 16 sector 
formats . 

DISK ORGANIZATION 

TRACKS 

All DOS versions 35 

SECTORS PER TRACK 

DOS 3.2.1 and earlier 13 

DOS 3.3 16 

SECTORS PER DISKETTE 

DOS 3.2.1 and earlier 455 

DOS 3.3 560 

BYTES PER SECTOR 

All DOS versions 256 

BYTES PER DISKETTE 

DOS 3.2.1 and earlier 116480 

DOS 3.3 143360 

USABLE* SECTORS FOR DATA STORAGE 

DOS 3.2.1 and earlier 403 

DOS 3.3 496 

USABLE* BYTES PER DISKETTE 

DOS 3.2.1 and earlier 103168 

DOS 3.3 126976 

* Excludes DOS, VTOC, and CATALOG 
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TRACK FORMATTING 

Up to this point we have broken down the structure of data 
to the track and sector level. To better understand how 
data is stored and retrieved, we will start at the bottom 
and work up. 

As this manual is primarily concerned with software, no 
attempt will be made to deal with the specifics of the 
hardware. For example, while in fact data is stored as a 
continuous stream of analog signals, we will deal with 
discrete digital data, i.e. a or a 1 . We recognize that 
the hardware converts analog data to digital data but how 
this is accomplished is beyond the scope of this manual. 

Data bits are recorded on the diskette in precise intervals. 
The hardware recognizes each of these intervals as either a 
or a 1 . We will define these intervals to be "bit cells". 
A bit cell can be thought of as the distance the diskette 
moves in four machine cycles, which is about four 
microseconds. Using this representation, data written to 
and read back from the diskette takes the form shown in 
Figure 3.2. The data pattern shown represents a binary 
value of 101. 



BITS ON DISK 
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A byte as recorded on the disk consists of eight (8) 
consecutive bit cells. The most significant bit cell is 
usually referred to as bit cell 7 and the least significant 
bit cell as bit cell 0. When reference is made to a 
specific data bit (i.e. data bit 5), it is with respect to 
the corresponding bit cell (bit cell 5). Data is written 
and read serially, one bit at a time. Thus, during a write 
operation, bit cell 7 of each byte is written first, with 
bit cell written last. Correspondingly, when data is 
being read back from the diskette, bit cell 7 is read first 
and bit cell is read last. Figure 3.4 illustrates the 
relationship of the bits within a byte. 
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ONE BYTE ON DISK 
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FIGURE 3.4 
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Figure 3.5 shows the three bits, 101, being read from the 
diskette data stream into the data latch. Of course another 
five bits would be read to fill the latch. 

Writing data can be depicted in much the same way (see 
Figure 3.6). It should be noted that, while in write mode, 
zeros are being brought into the data latch to replace the 
data being written. It is the task of the software to make 
sure that the latch is loaded and instructed to write in 32 
cycle intervals. If not, zero bits will continue to be 
written every four cycles, which is, in fact, exactly how 
self -sync bytes are created. Self sync bytes will be 
covered in detail shortly. 
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READING DATA FROM DISKETTE 
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WRITING DATA TO DISKETTE 



DATA LATCH 
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All gaps are primarily alike in content, consisting of 
self-sync hexadecimal FF's, and vary only in the number of 
bytes they contain. Figure 3.7 is a diagram of a portion of 
a typical track, broken into its major components. 



TRACK FORMAT 




FIGURE 3.7 



Self-sync or auto-sync bytes are special bytes that make up 
the three different types of gaps on a track. They are so 
named because of their ability to automatically bring the 
hardware into synchronization with data bytes on the disk. 
The difficulty in doing this lies in the fact that the 
hardware reads bits and the data must be stored as eight bit 
bytes. It has been mentioned that a track is literally a 
continuous stream of data bits. In fact, at the bit level, 
there is no way to determine where a byte starts or ends, 
because each bit cell is exactly the same, written in 
precise intervals with its neighbors. When the drive is 
instructed to read data, it will start wherever it happens 
to be on a particular track. That could be anywhere among 
the 50,000 or so bits on a track. Distinguishing clock bits 
from data bits, the hardware finds the first bit cell with 
data in it and proceeds to read the following seven data 
bits into the eight bit latch. In effect, it assumes that 
it had started at the beginning of a data byte. Of course, 
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in reality, the odds of its having started at the beginning 
of a byte are only one in eight. Pictured in Figure 3.8 is 
a small portion of a track. 



AN EXAMPLE BIT STREAM ON THE DISK 

0110101110101100111101101110101 

FIGURE 3.8 

There is no way from looking at the data to tell what bytes 
are represented, because we don't know where to start. This 
is exactly the problem that self-sync bytes overcome. 

A self-sync byte is defined to be a hexadecimal FF with a 
special difference. It is, in fact, a 10 bit byte rather 
than an eight bit byte. Its two extra bits are zeros. 
Figure 3.9 shows the difference between a normal data hex FF 
that might be found elsewhere on the disk and a self-sync 
hex FF byte. 



NORMAL BYTE HEX FF 
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FIGURE 3.9 



A self-sync is generated by using a 40 cycle (microsecond) 
loop while writing an FF. A bit is written every four 
cycles, so two of the zero bits brought into the data latch 
while the FF was being written are also written to the disk, 
making the 10 bit byte. (DOS 3.2.1 and earlier versions use 
a nine bit byte due to the hardware's inability to always 
detect two consecutive zero bits.) It can be shown, using 
Figure 3.10, that four self-sync bytes are sufficient to 
guarantee that the hardware is reading valid data. The 
reason for this is that the hardware requires the first bit 
of a byte to be a 1 . Pictured at the top of the figure is a 
stream of five FFs, four self-sync FFs followed by a normal 
FF . Each row below that demonstrates what the hardware will 
read should it start reading at any given bit in the first 
byte. In each case, by the time the four self -sync bytes 
have passed beneath the read/write head, the hardware will 
be "synced" to read the bytes that follow. As long as the 
disk is left in read mode, it will continue to correctly 
interpret the data unless there is an error on the track. 
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AUTOSYNC BYTES 



111111110011111111001111111100111111110011111111 


|1 1 1 1 1 1 1 1|0 0|1 1 1 1 1 1 1 1|0 0|1 1 1 1 1 1 1 1|0 0|1 1 1 1 1 1 1 1|0 0|1 1 1 1 1 1 1 1| 




1|1 1 1 1 1 1 1 0|0|1 1 1 1 1 1 1 1|0 0(1 1 1 1 1 1 1 1|0 0|1 1 1 1 1 1 1 1|0 oh 1 1 1 1 1 1 1| 




1 1 |1 1 1 1 1 1 0||1 1 1 1 1 1 1 1 1 o h 1 1 1 1 1 1 1 1 11 1 1 1 1 1 1 1 1 |1 1 1 1 1 1 1 1 1 




1 1 1|1 1 1 1 1 1||1 1 1 1 1 1 1 0|0 |l 1 1 1 1 1 1 1|0 0|1 1 1 1 1 1 1 1|0 0|1 1 1 1 1 1 1 1| 




1 1 1 1 |1 1 1 1 1 1||1 1 1 1 1 1 0W 1 1 1 1 1 1 1 1 0|1 1 1 1 1 1 1 1|0 ft 1 1 1 1 1 1 1| 




1 1 1 1 1 |1 1 1 1 1 1||1 1 1 1 1 1||1 1 1 1 1 1 1 0|0|1 1 1 1 1 1 1 1]0 0|1 1 1 1 1 1 1 1| 




1 1 1 1 1 1 |1 1 1 1 1 "I ||1 1110 1 1||1 1 1 1 1 1 0||1 1 1 1 1 1 1 1|0 |1 1 1 1 1 1 1 1| 




1 1 1 1 1 1 1 |1 1 1 1 1 -i III 1 1 1 1 1H1 1 1 1 1 1 Hi 1 1 1 1 1 1 0|0 |1 1 1 1 1 1 1 1| 




1 1 1 1 1 1 1 1 0|1 1 1 1 1 1 1 1|0 0|1 1 1 1 1 1 1 1 1 Oft 1 1 1 1 1 1 1 1 0|1 1 1 1 1 1 1 1| 



FIGURE 3.10 



We can now discuss the particular portions of a track in 
detail. The three gaps will be covered first. Unlike some 
other disk formats, the size of the three gap types will 
vary from drive to drive and even from track to track. 
During the initialization process, DOS will start with large 
gaps and keep making them smaller until an entire track can 
be written without overlapping itself. DOS makes sure that 
each gap type (see Figure 3.7) contains a minimum of four 
self-sync bytes. The result is fairly uniform gap sizes 
within each particular track. 
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Gap 1 is the first data written to a track during 
initialization. Its purpose is twofold. The gap originally 
consists of 128 bytes of self-sync, a large enough area to 
insure that all portions of a track will contain data. 
Since the speed of a particular drive may vary, the total 
length of the track in bytes is uncertain,, and the 
percentage occupied by data is unknown. The initialization 
process is set up, however, so that even on drives of 
differing speeds, the last data field written will overlap 
Gap 1, providing continuity over the entire physical track. 
Care is taken to make sure the remaining portion of Gap 1 is 
at least as long as a typical Gap 3 (in practice its length 
is usually more than 40 sync bytes), enabling it to serve as 
a Gap 3 type for Address Field number (See Figure 3.7 for 
clarity) . 

Gap 2 appears after each Address Field and before each Data 
Field. Its length varies from five to ten bytes on a normal 
drive. The primary purpose of Gap 2 is to provide time for 
the information in an Address Field to be decoded by the 
computer before a read or write takes place. If the gap were 
too short, the beginning of the Data Field might spin past 
while DOS was still determining if this was the sector to be 
read. The 240 odd cycles that six self-sync bytes provide 
seems ample time to decode an address field. When a Data 
Field is written there is no guarantee that the write will 
occur in exactly the same spot each time. This is due to 
the fact that the drive which is rewriting the Data Field 
may not be the one which originally INITed or wrote it. 
Since the speed of the drives can vary, it is possible that 
the write could start in mid-byte. (See Figure 3.11) This is 
not a problem as long as the difference in positioning is 
not great. To insure the integrity of Gap 2, when writing a 
data field, five self-sync bytes are written prior to 
writing the Data Field itself. This serves two purposes. 
Since relatively little time is spent decoding an address 
field, the five bytes help place the Data Field near its 
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original position. Secondly, and more importantly, the five 
self-sync bytes guarantee read synchronization. It is 
probable that, in writing a data field, at least one sync 
byte will be destroyed. This is because, just as in reading 
bits on the track, the write may not begin on a byte 
boundary, thus altering an existing byte. Figure 3.12 
illustrates this. 



WRITING OUT OF SYNC 



Before 



f 



~L 



h^-tu —ru- 



write starts here 



After 



<7 



-^-TU^^-TL- 



h*_tu *. 



FIGURE 3.12 



Gap 3 appears after each Data Field and before each Address 
Field. It is longer than Gap 2 and generally ranges from 14 
to 24 bytes in length. It is quite similar in purpose to 
Gap 2. Gap 3 allows the additional time needed to 
manipulate the data that has been read before the next 
sector is to be read. The length of Gap 3 is not as 
critical as that of Gap 2. If the following Address Field 
is missed, DOS can always wait for the next time it spins 
around under the read/write head, at most one revolution of 
the disk. Since Address Fields are never rewritten, there 
is no problem with this gap providing synchronization, since 
only the first part of the gap can be overwritten or 
damaged. (See Figure 3.11 for clarity) 

An examination of the contents of the two types of fields is 
in order. The Address Field contains the "address" or 
identifying information about the Data Field which follows 
it. The volume, track, and sector number of any given 
sector can be thought of as its "address", much like a 
country, city, and street number might identify a house. As 
shown previously in Figure 3.7, there are a number of 
components which make up the Address Field. A more detailed 
illustration is given in Figure 3.13. 
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ADDRESS FIELD 



VOLUME TRACK SECTOR CHECKSUM EPILOGUE 



D5 AA 96 XX YY XX YY XX YY XX YY DE AA EB 



ODD-EVEN ENCODED 

DATA BYTE — D7D6DsD«D3D2DiDo 
XX — 1 T> 1 Ds 1 Da 1 D. 
YY — 1 De 1 D4 1 D? 1 Do 

FIGURE 3.13 



The prologue consists of three bytes which form a unique 
sequence, found in no other component of the track. This 
fact enables DOS to locate an Address Field with almost no 
possibility of error. The three bytes are $D5, $AA, and 
$96. The $D5 and $AA are reserved (never written as data) 
thus insuring the uniqueness of the prologue. The $96, 
following this unique string, indicates that the data 
following constitutes an Address Field (as opposed to a Data 
Field). The address information follows next, consisting of 
the volume, track, and sector number and a checksum. This 
information is absolutely essential for DOS to know where it 
is positioned on a particular diskette. The checksum is 
computed by exclusive-ORing the first three pieces of 
information, and is used to verify its integrity. Lastly 
follows the epilogue, which contains the three bytes $DE, 
$AA and $EB. Oddly, the $EB is always written during 
initialization but is never verified when an Address Field 
is read. The epilogue bytes are sometimes referred to as 
"bit-slip marks", which provide added assurance that the 
drive is still in sync with the bytes on the disk. These 
bytes are probably unnecessary, but do provide a means of 
double checking. 
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The other field type is the Data Field. Much 
Address Field, it consists of a prologue, data 
and an epilogue. (Refer to Figure 3.14) The pr 
different only in the third byte. The bytes ar 
and $AD, which again form a unique sequence, e 
locate the beginning of the sector data. The 
of 342 bytes of encoded data. The encoding sc 
be discussed in the next section. The data is 
checksum byte, used to verify the integrity of 
read. The epilogue portion of the Data Field 
identical to the epilogue in the Address Field 
the same function. 



DATA FIELD 
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CHECKSUM 



D5 AA AD 342 BYTES DATA 



XX DE AA EB 



SIX AND TWO 
ENCODED 



FIGURE 3.14 



DATA FIELD ENCODING 

Due to Apple's hardware, it is not possible to read all 256 
possible byte values from a diskette. This is not a great 
problem, but it does require that the data written to the 
disk be encoded. Three different techniques have been 
used. The first one, which is currently used in Address 
Fields, involves writing a data byte as two disk bytes, one 
containing the odd bits, and the other containing the even 
bits. It would thus require 512 "disk" bytes for each 256 
byte sector of data. Had this technique been used for 
sector data, no more than 10 sectors would have fit on a 
track. This amounts to about 88K of data per diskette, or 
roughly 72K of space available to the user; typical for 
5 1/4 single density drives. 
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Fortunately, a 
was devised th 
method involve 
the "4 and 4" 
disk contains 
requires 410 " 
latter density 
track format u 
scheme represe 
drives of the 



second technique for writing data to diskette 
at allows 13 sectors per track. This new 
d a "5 and 3" split of the data bits, versus 
mentioned earlier. Each byte written to the 
five valid bits rather than four. This 
disk" bytes to store a 256 byte sector. This 

allows the now well known 13 sectors per 
sed by DOS 3 through DOS 3.2.1. The "5 and 3" 
nted a hefty 33% increase over comparable 
day . 



Currently, of course, DOS 3.3 features 16 sectors per track 
and provides a 23% increase in disk storage over the 13 
sector format. This was made possible by a hardware 
modification (the P6 PROM on the disk controller card) which 
allowed a "6 and 2" split of the data. The change was to 
the logic of the "state machine" in the P6 PROM, now 
allowing two consecutive zero bits in data bytes. 

These three different encoding techniques will now be 
covered in some detail. The hardware for DOS 3.2.1 (and 
earlier versions of DOS) imposed a number of restrictions 
upon how data could be stored and retrieved. It required 
that a disk byte have the high bit set and, in addition, no 
two consecutive bits could be zero. The odd-even "4 and 4" 
technique meets these requirements. Each data byte is 
represented as two bytes, one containing the even data bits 
and the other the odd data bits. Figure 3.15 illustrates 
this transformation. It should be noted that the unused 
bits are all set to one to guarantee meeting the two 
requirements . 



DATA BYTE D7D6D5D4D3D2D1D0- 



ID7ID5ID3ID. 
ID6ID4ID2ID0 



FIGURE 3.15 



No matter what value the original data data byte has, this 
technique insures that the high bit is set and that there 
can not be two consecutive zero bits. The "4 and 4" 
technique is used to store the information (volume, track, 
sector, checksum) contained in the Address Field. It is 
quite easy to decode the data, since the byte with the odd 
bits is simply shifted left and logically ANDed with the 
byte containing the even bits. This is illustrated in Figure 
3.16. 



Dj 1 Ds 1 Dj 1 D. 1 
AND 1 De 1 Da 1 D2 1 Do 

D7D6D5D4D3D2D1D0 
FIGURE 3.16 
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It is important that the least significant bit contain a 1 
when the odd-bits byte is left shifted. The entire 
operation is carried out in the RDADR subroutine at $B944 in 
DOS (48K). 

The major difficulty with the above technique is that it 
takes up a lot of room on the track. To overcome this 
deficiency the "5 and 3" encoding technique was developed. 
It is so named because, instead of splitting the bytes in 
half, as in the odd-even technique, they are split five and 
three. A byte would have the form 000XXXXX, where X is a 
valid data bit. The above byte could range in value from 
$00 to $1F, a total of 32 different values. It so happens 
that there are 34 valid "disk" bytes, ranging from $AA up to 
$FF, which meet the two requirements (high bit set, no 
consecutive zero bits). Two bytes, $D5 and $AA, were chosen 
as reserved bytes, thus leaving an exact mapping between 
five bit data bytes and eight bit "disk" bytes. The process 
of converting eight bit data bytes to eight bit "disk" 
bytes, then, is twofold. An overview is diagrammed in Figure 
3.17. 
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First, the 256 bytes that will make up a sector must be 
translated to five bit bytes. This is done by the 
"prenibble" routine at $B800. It is a fairly involved 
process, involving a good deal of bit rearrangement. Figure 
3.18 shows the before and after of prenibbilizing . On the 
left is a buffer of eight bit data bytes, as passed to the 
RWTS subroutine package by DOS. Each byte in this buffer is 
represented by a letter (A, B, C, etc.) and each bit by a 
number (7 through 0) . On the right side are the results of 
the transformation. The primary buffer contains five 
distinct areas of five bit bytes (the top three bits of the 
eight bit bytes zero-filled) and the secondary buffer 
contains three areas, graphically illustrating the name "5 
and 3". 
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FIGURE 3.18 



A total of 410 bytes are needed to store the origina 
This can be calculated by finding the total bits of 
(256 x 8 = 2048) and dividing that by the number of 
byte (2048 / 5 = 409.6). (two bits are not used) One 
process is completed, the data is further transforme 
make it valid "disk" bytes, meeting the disk's 
requirements. This is much easier, involving a one 
look-up in the table given in Figure 3.19. 
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"5 and 3" 
WRITE TRANSLATE TABLE 



00 = AB 

01 = AD 

02 = AE 

03 = AF 

04 = B5 

05 = B6 

06 = B7 

07 = BA 

08 = BB 

09 = BD 
0A = BE 
0B = BF 
0C = D6 
0D = D7 
0E = DA 
OF = DB 



10 = 


DD 


11 = 


DE 


12 = 


DF 


13 = 


EA 


14 = 


EB 


15 = 


ED 


16 = 


EE 


17 = 


EF 


18 = 


F5 


19 = 


F6 


1A = 


F7 


1B = 


FA 


1C = 


FB 


1D = 


FD 


1E = 


FE 


1F = 


FF 



AA I 

nt - J Reserved Bytes 



FIGURE 3.19 



The Data Field has a checksum much like the one in the 
Address Field, used to verify the integrity of the data. It 
also involves exclusive-ORing the information, but, due to 
time constraints during reading bytes, it is implemented 
differently. The data is exclusive-ORed in pairs before 
being transformed by the look-up table in Figure 3.19. This 
can best be illustrated by Figure 3.20 on the following 
page.* 



The reason for this transformation 
by examining how the information is 
disk. The read routine must read a 
store it — all in under 32 cycles 
a byte) or the information will be 
checksum computation to decode data 
shown in Figure 3.20 greatly facili 
constraint. As the data is being r 
accumulator contains the cumulative 
bytes, exclusive-ORed together. Th 
accumulator after any exclusive-OR 
data byte for that point in the ser 
diagrammed in Figure 3.21.* 
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♦Figures 3.20 and 3.21 present the nibblizing process used 
by the "6 and 2" encoding technique. However, the concept 
is the same for the "5 and 3" technique. 
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WRITING TO DISKETTE, DOS 3.3 
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READING FROM DISKETTE, DOS 3.3 



Disk Byte 
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TRANSLATE 
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Byte 340 
Byte 341 
Byte 342 



EFFECTIVE 
ACTION 

EORO 

EOR SBC55 
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FIGURE 3.21 
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The third encoding technique, currently used by DOS 3.3, is 
similar to the "5 and 3". It was made possible by a change 
in the hardware which eased the requirements for valid data 
somewhat. The high bit must still be set, but now the byte 
may contain one (and only one) pair of consecutive zero 
bits. This allows a greater number of valid bytes and 
permits the use of a "6 and 2" encoding technique. A six 
bit byte would have the form OOXXXXXX and has values from 
$00 to $3F for a total of 64 different values. With the 
new, relaxed requirements for valid "disk" bytes there are 
70 different bytes ranging in value from $95 up to $FF. 
After removing the two reserved bytes, $AA and $D5, there 
are still 68 "disk" bytes with only 64 needed. So an 
additional requirement was introduced to force the mapping 
to be one to one, namely, that there must be at least two 
adjacent bits set, excluding bit 7. This eliminates four 
more bytes and produces exactly 64 valid "disk" values. The 
initial transformation is done by the prenibble routine 
(still located at $B800) and its results are shown in Figure 
3.22. 

"6 and 2" PRENIBBILIZING 
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IT'S QUITE SIMPLE, - *6anp2" IS LESS THAN vv 5am>5 . 



A total of 342 bytes are needed, shown by finding the total 
^number of bits (256 x 8 = 2048) and dividing by the number 

of bits per byte (2048 / 6 = 341.33). The transformation 
— from the six bit bytes to valid data bytes is again 
^performed by a one to one mapping shown in Figure 3.23. 

Once again, the stream of data bytes written to the diskette 
3 are a product of exclusive-ORs , exactly as with the "5 and 

3" technique discussed earlier. 
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SECTOR INTERLEAVING 

Sector interleaving, or skewing, is the staggering of 
sectors on a track to maximize access speed. There is 
usually a delay between the time DOS reads or writes a 
sector and the time it is ready to read or write another. 
This delay depends upon the application program using the 
disk and can vary greatly. If sectors were stored on the 
track in sequential order, it would usually be necessary to 
wait a full revolution of the diskette before the next 
sector could be accessed. Ordering the sectors non- 
sequentially (skewing them) can provide improved access 
speeds . 

On DOS 3.2.1 and earlier versions, the 13 sectors are 
physically skewed on the diskette. During the boot 
operation, sectors are loaded from the diskette in ascending 
sequential order. However, files generally are loaded in 
descending sequential order. As a result, no single skewing 
scheme works well for both booting and sequentially 
accessing a file. 

A different approach has been used in DOS 3.3 in an attempt 
to maximize performance. The skewing is now done in 
software. The 16 physical sectors are numbered in ascending 
order (0, 1, 2, ... , 15) and are not physically skewed at 
all. A look-up table is used to translate a logical or soft 
sector number used by RWTS into the physical sector number 
found on the diskette. For example, if the logical sector 
number were a 2, this would be translated into the physical 
sector number 11 ($0B). Thus, RWTS treats physical sector 
11 ($0B) as sector 2 for all intents and purposes. This 
presents no problem if RWTS is used for disk access, but 
would become a consideration if access were made without 
RWTS. DOS 3.3 uses what we refer to as a "2 descending" 
skew. 

In an attempt to eliminate the access differences between 
booting and reading files, another change was made to DOS 
3.3. During the boot process, DOS is loaded backwards in 
descending sequential order into memory, just as files are 
accessed. However, due to differences in the delays for 
booting and reading files, no single skewing scheme is 
optimal. For a detailed discussion of this subject refer to 
HOW SECTOR SKEWING CAN AFFECT DISK PERFORMANCE in the 
documentation for BAG OF TRICKS*. 

It is interesting to point out that Pascal, Fortran, and 
CP/M diskettes all use software skewing also. However, each 
uses a different sector order. Pascal and Fortran use a 2 
ascending skew and CP/M diskettes use a 3 ascending skew. A 
comparison of these differences is presented in Figure 3.24. 



* see the page opposite page 1-1 for a description of BAG OF 
TRICKS. 
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CHAPTER 4 

DISKETTE ORGANIZATION 



As was described in CHAPTER 3, a 16 sector diskette consists 
of 560 data areas of 256 bytes each, called sectors. These 
sectors are arranged on the diskette in 35 concentric rings 
or tracks of 16 sectors each. The way DOS allocates these 
tracks of sectors is the subject of this chapter. 

A file (be it APPLESOFT, INTEGER, BINARY, or TEXT type) 
consists of one or more sectors containing data. Since the 
sector is the smallest unit of allocatable space on a 
diskette, a file will use up at least one sector even if it 
is less than 256 bytes long; the remainder of the sector is 
wasted. Thus, a file containing 400 characters (or bytes) 
of data will occupy one entire sector and 144 bytes of 
another with 112 bytes wasted. Knowing these facts, one 
would expect to be able to use up to 16 times 35 times 256 
or 143,360 bytes of space on a diskette for files. Actually, 
the largest file that can be stored is about 126,000 bytes 
long. The reason for this is that some of the sectors on the 
diskette must be used for what is called "overhead". 

CATALOG 

DISK VOLUME 001 

*I 002 HELLO 

A 002 APPLESOFT PROGRAM 

T 002 TEXT PILE 

B 002 BINARY PILE 

TRACK 

* 2 3 4 5 6 7 B 9 10 11 12 13 11 15 16 17 16 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 




FREE 
SECTORS 




FREE 
SECTORS 



HELLO 

APPLESOFT PROGRAM 

TEXT FILE 



BINARY FILE 
I 



A TYPICAL 16 SECTOR DISKETTE MAP 

FIGURE 4.1 
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Overhead sectors contain the image of DOS which is loaded 
when booting the diskette, a list of the names and locations 
of the files on the diskette, and an accounting of the 
sectors which are free for use with new files or expansions 
of existing files. An example of the way DOS uses sectors is 
given in Figure 4.1. 

DISKETTE SPACE ALLOCATION 

The map in Figure 4.1 shows that the first three tracks of 
each diskette are always reserved for the bootstrap image of 
DOS. In the exact center track (track 17) is the VTOC and 
catalog. The reason for placing the catalog here is simple. 
Since the greatest delay when using the disk is waiting for 
the arm to move from track to track, it is advantageous to 
minimize this arm movement whenever possible. By placing 
the catalog in the exact center track of the disk, the arm 
need never travel more than 17 tracks to get to the catalog 
track. As files are allocated on a diskette, they occupy 
the tracks just above the catalog track first. When the 
last track, track 34, has been used, track 16, the track 
adjacent and below the catalog, is used next, then 15, 14, 
13, and so on, moving away from the catalog again, toward 
the DOS image tracks. If there are very few files on the 
diskette, they will all be clustered, hopefully, near the 
catalog and arm movement will be minimized. Additional space 
for a file, if it is needed, is first allocated in the same 
track occupied by the file. When that track is full, 
another track is allocated elsewhere on the disk in the 
manner described above. 

THE VTOC 

The Volume Table Of Contents is the "anchor" of the entire 
diskette. On any diskette accessible by any version of DOS, 
the VTOC sector is always in the same place; track 17, 
sector 0. (Some protected disks have the VTOC at another 
location and provide a special DOS which can find it.) Since 
files can end up anywhere on the diskette, it is through the 
VTOC anchor that DOS is able to find them. The VTOC of a 
diskette has the following format (all byte offsets are 
given in base 16, hexadecimal): 

VOLUME TABLE OF CONTENTS (VTOC) FORMAT 



■? 



I 



Imp 

!- 






5 
£ 



4 



28-2F Not used 

30 Last track where sectors were allocated 

31 Direction of track allocation (+1 or -1) 
32-33 Not used 

34 Number of tracks per diskette (normally 35) 

35 Number of sectors per track (13 or 16) 
36-37 Number of bytes per sector (LO/HI format) 
38-3B Bit map of free sectors in track 
3C-3F Bit map of free sectors in track 1 
40-43 Bit map of free sectors in track 2 

BC-BF Bit map of free sectors in track 33 

C0-C3 Bit map of free sectors in track 34 

C4-FF Bit maps for additional tracks if there are more 
than 35 tracks per diskette 



1 



BIT MAPS OF FREE SECTORS ON A GIVEN TRACK 

A four byte binary string of ones and zeros, 
representing free and allocated sectors respectively. 
Hexadecimal sector numbers are assigned to bit 
positions as follows: 

BYTE SECTORS 

+0 FEDC BA98 

+1 7654 3210 

+ 2 (not used) 

+ 3 (not used) 

Thus, if only sectors E and 8 are free and all 
others are allocated, the bit map will be: 

41000000 

If all sectors are free: 

FFFFOO00 

An example of a VTOC sector is given in Figure 4.2. This 
VTOC corresponds to the map of the diskette given in Figure 
4.1. 



BYTE 

00 

01 

02 

03 

04-05 

06 

07-26 

27 
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DESCRIPTION 

Not used 

Track number of first catalog sector 

Sector number of first catalog sector 

Release number of DOS used to INIT this diskette 

Not used 

Diskette volume number (1-254) 

Not used , 

Maximum number of track/sector pairs which will fit 

in one file track/sector list sector (122 for 256 

byte sectors) 
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122 T/S pairs 
in a T/S list 



Last track 
allocated 
was 15 (hex). 
Next will be 
15+1=16 (hex). 
(22 decimal) 



First CATALOG sector is on track 11 (hex), 
sector OF (hex) 

— DOS 3.3 




23 (hex) tracks/disk 
10 (hex) sectors/track 



oo O4 |iiof103| oooo|oi|oooopoooo^ 
_oc ooooooooooooooopflooopdoo 

18~TOGQ5OOOOOOOOQ0DOOO0OOOOO 
24 000O O of73oQgOO00jB60000000 ...Z. 
15Q]|000C 2310|0001JOOOOOOOO| ^7TTTT: 



0100 (hex) bytes/sector 



Track is 
allocated 



oooooooci onoooooopppgDooo 



48 FFFFOOOOFFFFOOOOFFFFOOOO 
54 FFFFOOOOFFFFOOOOFFFFOOOO 
60 FFFFOOOOFFFFOOOO lPFFFOOOOt - 
6C FFFFOOOOFFFFOOOOFFFFOOOO 
78 FFFF0000OOO0O0O0 |3FFFOOO0 
84 3FFF00003FFF00003FFF0000 
90 FFFFOOOOFFFFOOOOFFFFOOOO 
9C FFFFOOOOFFFFOOOOFFFFOOOO 
A8 FFFFOOOOFFFFOOOOFFFFOOOO 
B4 FFFFOOOOFFFFOOOOFFFFOOOO 
CO IFFFFOOOOJ OOOOO OOOOOOOOOOO 
CC 000000000000000000000000 
D8 000000000000000000000000 
E4 000000000000000000000000 
FO 000000000000000000000000 
FC 00000000 



Track 1 is 
allocated 

Track 12 is 
free 

Only sectors 
14 and 15 are 
allocated 
on track 18 



Track 34 
is free 



FIGURE 4.2 - EXAMPLE VTOC 
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THE CATALOG 





Sector 



Sector 1 



Sector 2 



Sector 3 



Sectors 4-B 



etc. 



Third 7 
Filenames 



Sector C 



Sector D 



Second 7 
Filenames 



In order for DOS to find a 
given file, it must first read 
the VTOC to find out where the 
first catalog sector is 
located. Typically, the 
catalog sectors for a diskette 
are the remaining sectors on 
track 17, following the VTOC 
sector. Of course, as long as 
a track/sector pointer exists 
in the VTOC and the VTOC is 
located at track 17, sector 0, 
DOS does not really care where 
the catalog resides. Figure 
4.3 diagrams the catalog 
track. The figure shows the 
track/sector pointer in the 
VTOC at bytes 01 and 02 as an 
arrow pointing to track 17 (11 
in hexadecimal) sector F. The 
last sector in the track is 
the first catalog sector and 
describes the first seven 
files on the diskette. Each 
catalog sector has a 
track/sector pointer in the 
same position (bytes 01 and 
02) which points to the next 
catalog sector. The last 
catalog sector (sector 1) has 
a zero pointer to indicate 
that there are no more catalog 
sectors in the chain. 

In each catalog sector up to 
seven files may be listed and 
described. Thus, on a typical 
DOS 3.3 diskette, the catalog 
can hold up to 15 times 7, or 
105 files. A catalog sector is 
formatted as described on the 
following page. 



Sector E 



First 7 
Filenames 



Sector F 



FIGURE 4.3 - TRACK 17, THE CATALOG TRACK 
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CATALOG SECTOR FORMAT 

BYTE DESCRIPTION 

00 Not used 

01 Track number of next catalog sector (usually 
2 Sector number of next catalog sector 

03-OA Not used 

0B-2D First file descriptive entry 

2E-50 Second file descriptive entry 

51-73 Third file descriptive entry 

74-96 Fourth file descriptive entry 

97-B9 Fifth file descriptive entry 

BA-DC Sixth file descriptive entry 

DD-FF Seventh file descriptive entry 
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FILE DESCRIPTIVE ENTRY FORMAT 



RELATIVE 

BYTE 

00 



01 
02 



DESCRIPTION 

Track of first track/sector list sector. 

If this is a deleted file, this byte contains a hex 

FF and the original track number is copied to the 

last byte of the file name field (BYTE 20) . 

If this byte contains a hex 00, the entry is assumed 

to never have been used and is available for use. 

(This means track can never be used for data even 

if the DOS image is "wiped" from the diskette.) 

Sector of first track/sector list sector 

File type and flags: 

Hex 80+file type - file is locked 

00+file type - file is not locked 



ft j > 

11 hex) W£\ ^ 



00 

01 

02 

04 

08 

10 

20 

40 

(thus , 

locked 

File name 



TEXT file 

INTEGER BASIC file 

APPLESOFT BASIC file 

- BINARY file 

- S type file 

- RELOCATABLE object module file 

- A type file 

- B type file 

84 is a locked BINARY file, and 90 is a 
R type file) 

03-20 File name (30 characters) 

21-22 Length of file in sectors (LO/HI format) . 

The CATALOG command will only format the LO byte of 
this length giving 1-255 but a full 65,535 may be 
stored here. 



Figure 4.4 is an example of a typical catalog sector. In 
this example there are only four files on the entire 
diskette, so only one catalog sector was needed to describe 
them. There are four entries in use and three entries which 
have never been used and contain zeros. 



• 



3 

3 



Applesoft 
J type file 

1 

J 

3 
I 

3 

t 

! 
! 



Next CATALOG sector is track 11 (hex), 
sector 0E (hex) 



First track/sector list for this file 
is at track 12 (hex), sector OF (hex) 



81 = locked, integer BASIC type file 
File name is "HELLO" 



00 QOfllOEfc ) QOOOOOOOOOOOOOOll 2| 
OC |0FP l)c_8CPCCCCCFAOAOAOAOAO 




18 AOAOAOAOAOAOAOAOAOAOAOAO 

24 AOAOAOAOAOAOAOA O)02O0| ITOT 

^Q~]02|C1D0D0CCC5D3CFC6D4A0D0 .APPLESOFT P 
3C D2CFC7D2C1CDA0A0A0A0A0A0 ROGRAM 

48 AOAOAOAOA0AOAO02OO14Or|O0| 

54 D4C5D8D4A0C6C9CCC5A0A0A0 TEXT FILE 
60 AOAOAOAOAOAOAOAOAOAOAOAO 



6C AOA0A0A0A0A0020015O^O^CS B 

78 C9CEC1D2D9A0C6C9CCC5A0A0 INARY FILE 
84 AOAOAOAOAOAOAOAOAOAOAOAO 

90 A0A0A0AOA0020O000000O000 

9C OOOOOOOOOOOOOOOOOOOOOOOO 

A8 OOOOOOOOOOOOOOOOOOOOOOOO 

B4 OOOOOOOOOOOOOOOOOOOOOOOO 

CO OOOOOOOOOOOOOOOOOOOOOOOO 

CC OOOOOOOOOOOOOOOOOOOOOOOO 

D8 OOOOOOOOOOOOOOOOOOOOOOOO 

E4 OOOOOOOOOOOOOOOOOOOOOOOO 

FO OOOOOOOOOOOOOOOOOOOOOOOO 

FC OOOOOOOO .... 



FIGURE 4.4 — EXAMPLE CATALOG SECTOR 



File length 
is 2 sectors 



Text type 
file 

Binary type 
file 
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THE TRACK/SECTOR LIST 

Each file has associated with it a "Track/Sector List" 
sector. This sector contains a list of track/sector pointer 
pairs which sequentially list the data sectors which make up 
the file. The file descriptive entry in the catalog sector 
points to this T/S List sector which, in turn, points to 
each sector in the file. This concept is diagramed in Figure 
4.5. 



TRACK 17 
SECTOR 




* j ^ 

We ' s 

* i 3 



THIRD 

SECTOR OF 

'HELLO' 



FIRST 

SECTOR OF 

"HELLO" 



DATA SECTORS 



FIGURE 4.5 - PATH DOS MUST FOLLOW TO FIND A FILE 

The format of a Track/Sector List sector is given below. 
Note that since even a minimal file requires one T/S List 
sector and one data sector, the least number of sectors a 
non-empty file can have is 2. Also, note that a very large 
file, having more than 122 data sectors, will need more than 
one Track/Sector List to hold all the Track/Sector pointer 
pairs . 



BYTE 
00 

01 

02 
03-04 
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TRACK/SECTOR LIST FORMAT 

DESCRIPTION 

Not used 

Track number of next T/S List sector if one was 

needed or zero if no more T/S List sectors. 

Sector number of next T/S List sector (if present) 

Not used 



■I 



05-06 Sector offset in file of the first sector described 

by this list. 
07-0B Not used 

0C-0D Track and sector of first data sector or zeros 
0E-0F Track and sector of second data sector or zeros 
10-FF Up to 120 more Track/Sector pairs 



*: * 



3 
3 
3 

1 

P 
11 

-1 
1 



, There are no additional T/S list 

sectors for this file 



The first sector listed here 
is sector of the file 



The first data sector is on 
track 12 (hex), sector 0E (hex) 



There is no second sector 



oo o|o|oooc|ooo o |ooook )ooooooooo 
oc |i20E|oooo Toooooooooooooooo 

18 000000000000000000000000 
24 000000000000000000000000 
30 000000000000000000000000 
3C 000000000000000000000000 
48 000000000000000000000000 
54 000000000000000000000000 
60 000000000000000000000000 
6C 000000000000000000000000 
78 000000000000000000000000 
84 000000000000000000000000 
90 000000000000000000000000 
9C 000000000000000000000000 
A8 000000000000000000000000 
B4 000000000000000000000000 
CO 000000000000000000000000 
CC 000000000000000000000000 
D8 000000000000000000000000 
E4 000000000000000000000000 
FO 000000000000000000000000 
FC 00000000 



FIGURE 4.6 — EXAMPLE TRACK/SECTOR LIST 
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■ ': si 



A sequential file will end when the first zero T/S List 

entry is encountered. A random file, however, can have B 1 

spaces within it which were never allocated and therefore 

have no data sectors allocated in the T/S List. This _^ 

distinction is not always handled correctly by DOS. The 

VERIFY command, for instance, stops when it gets to the 

first zero T/S List entry and can not be used to verify some K 

random organization text files. ^ 

An example T/S List sector is given in Figure 4.6. The Jfc 

example file (HELLO, from our previous examples) has only 

one data sector, since it is less than 256 bytes in length. ^r 

Counting this data sector and the T/S List sector, HELLO is 

2 sectors long, and this will be the value shown when a 

CATALOG command is done . &- 



Following the T 
we come to the 
the data sector 
become apparent 
file) are consi 
though they mus 
sectors on the 
necessarily con 
diskette) , by u 
sector of the f 
programmer need 
sectors at all. 

TEXT FILES 



rack/Sector pointer in the T/S List sector, 
first data sector of the file. As we examine 
s, the differences between the file types 
. All files (except, perhaps, a random TEXT 
dered to be continuous streams of data, even 
t be broken up into 256 byte chunks to fit in 
diskette. Although these sectors are not 
tiguous (or next to each other on the 
sing the Track/Sector List, DOS can read each 
ile in the correct order so that the 
never know that the data was broken up into 



The TEXT data type is the least complicated file data 
structure. It consists of one or more records, separated 
from each other by carriage return characters (hex 8D's). 
This structure is diagrammed and an example file is given in 
Figure 4.7. Usually, the end of a TEXT file is signaled by 
the presence of a hex 00 or the lack of any more data 
sectors in the T/S List for the file. As mentioned earlier, 
if the file has random organization, there may be hex 00' s 
imbedded in the data and even missing data sectors in areas 
where nothing was ever written. In this case, the only way 
to find the end of the file is to scan the Track/Sector List 
for the last non-zero Track/Sector pair. Since carriage 
return characters and hex 00' s have special meaning in a 
TEXT type file, they can not be part of the data itself. For 
this reason, and to make the data accessible to BASIC, the 
data can only contain printable or ASCII characters 
(alphabetics , numerics or special characters, see p. 8 in 
the APPLE II REFERENCE MANUAL) This restriction makes 
processing of a TEXT file slower and less efficient in the 
use of disk space than with a BINARY type file, since each 
digit must occupy a full byte in the file. 
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SI 

s 

s 

3 



i 

I 

ml 3 

ft-* ~3 

ft I 3 
I 



RECORD 1 (CR) RECORD 2 (CR) RECORD 3 (CR)lOO 



A Sequential Text Type File 



Record 1 



End of file 



1,2,3,4. 



00 BlACB2ftCB3ACB ^8C|0CJ OO0000 
OC 000000000000000000000000 
18 000000000000000000000000 
24 000000000000000000000000 
30 000000000000000000000000 
3C 000000000000000000000000 
48 000000000000000000000000 
54 000000000000000000000000 
60 000000000000000000000000 
6C 000000000000000000000000 
78 000000000000000000000000 
84 000000000000000000000000 
90 000000000000000000000000 
9C 000000000000000000000000 
A8 000000000000000000000000 
B4 000000000000000000000000 
CO 000000000000000000000000 
CC 000000000000000000000000 
D8 000000000000000000000000 
E4 000000000000000000000000 
FO 000000000000000000000000 
FC 00000000 



Example Text File Sector 



FIGURE 4.7 — TEXT FILE DATA TYPE 
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BINARY FILES 

The structure of a BINARY type file is shown in Figure 4.8. 
An exact copy of the memory involved is written to the disk 
sector (s) , preceded by the memory address where it was found 
and the length (a total of four bytes) . The address and 
length (in low order, high order format) are those given in 
the A and L keywords from the BSAVE command which created 
the file. Notice that DOS writes one extra byte to the 
file. This does not matter too much since BLOAD and BRUN 
will only read the number of bytes given in the length 
field. (Of course, if you BSAVE a multiple of 256 bytes, a 
sector will be wasted because of this error) DOS could be 
made to BLOAD or BRUN the binary image at a different 
address either by providing the A (address) keyword when the 
command is entered, or by changing the address in the first 
two bytes of the file on the diskette. 



APPLESOFT AND INTEGER FILES 

A BASIC program, be it APPLESOFT or INTEGER, is saved to the 
diskette in a way that is similar to BSAVE. The format of an 
APPLESOFT file type is given in Figure 4.9 and that of 
INTEGER BASIC in 4.10. When the SAVE command is typed, DOS 
determines the location of the BASIC program image in memory 
and its length. Since a BASIC program is always loaded at a 
location known to the BASIC interpreter, it is not necessary 
to store the address in the file as with a BINARY file. The 
length is stored, however, as the first two bytes, and is 
followed by the image from memory. Notice that, again, DOS 
incorrectly writes an additional byte, even though it will 
be ignored by LOAD. The memory image of the program consists 
of program lines in an internal format which is made up of 
what are called "tokens". A treatment of the structure of a 
BASIC program as it appears in memory is outside the scope 
of this manual, but a breakdown of the example INTEGER BASIC 
program is given in Figure 4.10. 



OTHER FILE TYPES (S,R, new A, new B) 

Additional file types have been defined within DOS as can be 
seen in the file descriptive entry format, shown earlier. No 
DOS commands at present use these additional types so their 
eventual meaning is anybody's guess. The R file type, 
however, has been used with the DOS TOOLKIT assembler for 
its output file, a relocatable object module. This file type 
is used with a special form of BINARY file which can contain 
the memory image of a machine language program which may be 
relocated anywhere in the machine based on additional 
information stored with the image itself. The format for 
this type of file is given in the documentation accompanying 
the DOS TOOLKIT. It is recommended that if the reader 
requires more information about R files he should refer to 
that documentation. 
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L/H 



L/H 



MEMORY IMAGE 



Address 



Length 

A Binary Type File 



Start address = 03DO (hex) 
File length = 0030 (hex) 



Binary memory image 



00 |D003|3000 4CBF9D4C849D4CFD P.0.L7.L..L] 

OC AA4CB5B7AD0F9DAC0E9D60AD *L57- l - 

18 C2AAACC1AA604C51A8EAEA4C B*, A* X LQ( JJL 

24 59FABF9D384C58FF4C65FF4C YZ? . 8LX_Le_L 

30 65FF65F^BE00000000000000 e_e_> 

3C OOOOOOOOOOOOOOOOOOOOOOOO 

48 OOOOOOOOOOOOOOOOOOOOOOOO 

54 OOOOOOOOOOOOOOOOOOOOOOOO 

60 OOOOOOOOOOOOOOOOOOOOOOOO 

6C OOOOOOOOOOOOOOOOOOOOOOOO 

78 OOOOOOOOOOOOOOOOOOOOOOOO 

84 OOOOOOOOOOOOOOOOOOOOOOOO 

90 OOOOOOOOOOOOOOOOOOOOOOOO 

9C OOOOOOOOOOOOOOOOOOOOOOOO 

A8 OOOOOOOOOOOOOOOOOOOOOOOO 

B4 OOOOOOOOOOOOOOOOOOOOOOOO 

CO OOOOOOOOOOOOOOOOOOOOOOOO 

CC OOOOOOOOOOOOOOOOOOOOOOOO 

D8 OOOOOOOOOOOOOOOOOOOOOOOO 

E4 OOOOOOOOOOOOOOOOOOOOOOOO 

FO OOOOOOOOOOOOOOOOOOOOOOOO 

FC 00000000 .... 



Example Binary File Sector 



FIGURE 4.8 - BINARY FILE DATA TYPE 
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L/H 



PROGRAM MEMORY IMAGE 



Length 
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An Applesoft Type File 



10 PRINT 


"[CTRL-D] OPEN TEXT FILE" 


20 PRINT 


"[CTRL-D] WRITE TEXT FILE" 


30 PRINT 


"1,2,3,4" 


40 PRINT 


"[CTRL-D] CLOSE TEXT FILE" 


50 END 





Program is 5E (hex) bytes long 

Applesoft program 



. . . . : " . WRIT 
E TEXT FILE" 
.?. .. 1*1,2,3 
,4".W.( . :".C 



00 [5E0C 18080A00BA22044F5045 " : " .OPE 

OC 4E20544S58542046494C4522 N TEXT FILE" 

18 0030081400BA220457524954 

24 4520S44558542046494C4522 

30 0O3F081EOOBA22312C322C33 

3C 2C3422O057082800BA220443 

48 4C4F534S20S4455854204649 LOSE TEXT FI 

54 4C45220O5DO832OO8OOOOOO0) LE" . ] . 2 

60 640000000000000000000000 d 

6C 000000000000000000000000 

78 000000000000000000000000 

84 000000000000000000000000 

90 000000000000000000000000 

9C 000000000000000000000000 

A8 000000000000000000000000 

B4 000000000000000000000000 

CO 000000000000000000000000 

CC 000000000000000000000000 

D8 000000000000000000000000 

E4 000000000000000000000000 

FO 000000000000000000000000 

FC 00000000 



Example Applesoft File Sector 



FIGURE 4.9 — APPLESOFT BASIC FILE TYPE 



1 

! 

ft j 3 

* i a 

m -i 

ft I 3 

m : ^ 

m 3 

3 



L/H 



PROGRAM MEMORY IMAGE 



Length 



An Integer Type File 



m> 3 

I 

■J 3 
■a. 3 

ml 3 

I 3 

I 



10 END 



Program is 5 bytes long 
Length of line (5 bytes) 
Line number (hex OA 

i "Tokens" 



51 
01 



10 decimal) 

END 

end of line 



00 |050C 050A00510J0500000000 Q. . . . , 

OC 000000000000000000000000 

18 000000000000000000000000 

30 000000000000000000000000 

3C 000000000000000000000000 

48 000000000000000000000000 

54 000000000000000000000000 

60 oooooooooooooooooooooooo 

6C oooooooooooooooooooooooo 

78 oooooooooooooooooooooooo , 

84 oooooooooooooooooooooooo , 

90 oooooooooooooooooooooooo 

9C oooooooooooooooooooooooo 

A8 oooooooooooooooooooooooo , 

B4 oooooooooooooooooooooooo 

CO oooooooooooooooooooooooo 

cc oooooooooooooooooooooooo 

D8 oooooooooooooooooooooooo 

E4 oooooooooooooooooooooooo 

FO oooooooooooooooooooooooo 

FC 00000000 

Example Integer File Sector 

FIGURE 4.10 - INTEGER BASIC FILE TYPE 
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EMERGENCY REPAIRS 

From time to time the information on a diskette can 
damaged or lost. This can create various symptoms, r 
from mild side effects, such as the disk not booting 
major problems, such as an input/output (I/O) error 
catalog. A good understanding of the format of a dis 
as described previously, and a few program tools can 
any reasonably sharp APPLE II user to patch up most 
on his diskettes. 



become 
anging 
, to 
in the 
kette, 
allow 
errors 



A first question would be, "how do errors occur". The most 
common cause of an error is a worn or physically damaged 
diskette. Usually, a diskette will warn you that it is 
wearing out by producing "soft errors". Soft errors are I/O 
errors which occur only randomly. You may get an I/O error 
message when you catalog a disk one time and have it catalog 
correctly if you try again. When this happens, the smart 
programmer immediately copies the files on the aged diskette 
to a brand new one and discards the old one or keeps it as a 
backup. 




EMERGENCY REPAIRS ARE EASIER IF YOU HAVE A BACKUP. 



Another 
hitting 
which is 
when the 
onto the 
being wr 
diskette 
drive or 
as well. 



cause of damaged diskettes is the practice of 
the RESET key to abort the execution of a program 
accessing the diskette. Damage will usually occur 
RESET signal comes just as data is being written 
disk. Powering the machine off just as data is 
itten to the disk is also a sure way to clobber a 
. Of course, real hardware problems in the disk 
controller card and ribbon cable can cause damage 
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If the damaged diskette 
easier. A damaged DOS 
usually be corrected by 
against the diskette or 
diskette. If only one f 
VERIFYed, it may be pos 
the file to another dis 
with an assembler progr 
BASIC program (if the f 
problem is a bad checks 
to read the bad sector 
the data. 



can be cataloged, recovery is much 
image in the first three tracks can 
running the MASTER CREATE program 
by copying all the files to another 
ile produces an I/O error when it is 
sible to copy most of the sectors of 
kette by skipping over the bad sector 
am which calls RWTS in DOS or with a 
ile is a TEXT file). Indeed, if the 
urn (see CHAPTER 3) it may be possible 
and ignore the error and get most of 



An I/O error usually means that one of two conditions has 
occurred. Either a bad checksum was detected on the data in e 
sector, meaning that one or more bytes is bad; or the 
sectoring is clobbered such that the sector no longer even 
exists on the diskette. If the latter is the case, the 
diskette (or at the very least, the track) must be 
reformatted, resulting in a massive loss of data. Although 
DOS can be patched to format a single track, it is usually 
easier to copy all readable sectors from the damaged 
diskette to another formatted diskette and then reconstruct 
the lost data there. 

Disk utilities, such as Quality Software's BAG OF TRICKS, 
allow the user to read and display the contents of sectors. 
BAG OF TRICKS will also allow you to modify the sector data 
and rewrite it to the same or another diskette. If you do 
not have BAG OF TRICKS or another commercial disk utility, 
you can use the ZAP program in APPENDIX A of this book. The 
ZAP program will read any track/sector on an unprotected 
diskette into memory, allowing the user to examine it or 
modify the data and then, optionally, rewrite it to a 
diskette. Using such a program is very important when 
learning about diskette formats and when fixing clobbered 
data. 

Using ZAP, a bad sector within a file can be localized by 
reading each track/sector listed in the T/S List sector for 
the file. If the bad sector is a catalog sector, the 
pointers of up to seven files may be lost. When this occurs, 
a search of the diskette can be made to find T/S List 
sectors which do not correspond to any files listed in the 
remaining "good" catalog sectors. As these sectors are 
found, new file descriptive entries can be made in the 
damaged sector which point to these T/S Lists. When the 
entire catalog is lost, this process can take hours, even 
with a good understanding of the format of DOS diskettes. 
Such an endeavor should only be undertaken if there is no 
other way to recover the data. Of course the best policy is 
to create backup copies of important files periodically to 
simplify recovery. More information on the above procedures 
is given in APPENDIX A. 
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A less significant form of diskette clobber, but very 
annoying, is the loss of free sectors. Since DOS allocates 
an entire track of sectors at a time while a file is open, 
hitting RESET can cause these sectors to be marked in use in 
the VTOC even though they have not yet been added to any T/S 
List. These lost sectors can never be recovered by normal 
means, even when the file is deleted, since they are not in 
its T/S List. The result is a DISK FULL message before the 
diskette is actually full. To reclaim the lost sectors it 
is necessary to compare every sector listed in every T/S 
List against the VTOC bit map to see if there are any 
discrepancies. There are utility programs which will do 
this automatically but the best way to solve this problem is 
to copy all the files on the diskette to another diskette 
(note that FID must be used, not COPY, since COPY copies an 
image of the diskette, bad VTOC and all). 

If a file is deleted it can usually be recovered, providing 
that additional sector allocations have not occured since it 
was deleted. If another file was created after the DELETE 
command, DOS might have reused some or all of the sectors of 
the old file. The catalog can be quickly ZAPped to move the 
track number of the T/S List from byte 20 of the file 
descriptive entry to byte 0. The file should then be copied 
to another disk and then the original deleted so that the 
VTOC freespace bit map will be updated. 






^ 



3 

3 



CHAPTER 5 

THE STRUCTURE OF DOS 



DOS MEMORY USE 

DOS is an assembly language program which is loaded into RAM 
memory when the user boots his disk. If the diskette booted 
is a master diskette, the DOS image is loaded into the last 
possible part of RAM memory, dependent upon the size of the 
actual machine on which it is run. By doing this, DOS fools 
the active BASIC into believing that there is actually less 
RAM memory on the machine than there is. On a 48K APPLE II 
with DOS active, for instance, BASIC believes that there is 
only about 38K of RAM. DOS does this by adjusting HIMEM 
after it is loaded to prevent BASIC from using the memory 
DOS is occupying. If a slave diskette is booted, DOS is 
loaded into whatever RAM it occupied when the slave diskette 
was INITialized. If the slave was created on a 16K APPLE, 
DOS will be loaded in the 6 to 16K range of RAM, even if the 
machine now has 48K. In this case, the APPLE will appear, 
for all intents an purposes, to have only 6K of RAM. If the 
slave was created on a 48K system, it will not boot on less 
than 48K since the RAM DOS occupied does not exist on a 
smaller machine. 



ANATOMY OF 
APPLE. DOS 
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A diagram of DOS's memory for a 48K APPLE II is given in 
Figure 5.1. As can be seen, there are four major divisions 
to the memory occupied by DOS. The first 1.75K is used for 
file buffers. With the default of MAXFILES 3, there are 
three file buffers set aside here. Each buffer occupies 595 
bytes and corresponds to one potentially open file. File 
buffers are also used by DOS to LOAD and SAVE files, etc. If 
MAXFILES is changed from 3, the space occupied by the file 
buffers also changes. This affects the placement of HIMEM, 
moving it up or down with fewer or more buffers 
respectively. 

The 3.5K above the file buffers is occupied by the main DOS 
routines. It is here that DOS's executable machine language 
code begins. The main routines are responsible for 
initializing DOS, interfacing to BASIC, interpreting 
commands, and managing the file buffers. All disk functions 
are passed on via subroutine calls to the file manager. 

The file manager, occupying about 2.8K, is a collection of 
subroutines which perform almost any function needed to 
access a disk file. Functions include: OPEN, CLOSE, READ, 
WRITE, POSITION, DELETE, CATALOG, LOCK, UNLOCK, RENAME, 
INIT, and VERIFY. Although the file manager is a subroutine 
of DOS it may also be called by a user written assembly 
lanaguage program which is not part of DOS. This interface 
is generalized through a group of vectors in page 3 of RAM 
and is documented in the next chapter . 



The last 2.5K of DOS is the Read/Write T 
package. RWTS is the next step lower in 
file manager - in fact it is called as a 
file manager. Where the file manager dea 
deals with tracks and sectors on the dis 
call to RWTS would be to read track 17 s 
256 bytes of data in memory onto track 5 
external interface is also provided for 
a user written assembly language program 
the next chapter . 



rack/Sector (RWTS) 
protocol from the 

subroutine by the 
Is with files, RWTS 
kette. A typical 
ector or to write 

sector E. An 
access to RWTS from 

and is described in 



5-2 



■5-3 

fe j a 

m i a 

£ | s 

fe | § 

mi ^ 
I 

■La 

mi . 4 

■' A 



SC00O 




SB600 



SAAC9 



S9D00 



$9600 



RWTS 



FILE MANAGER 



MAIN DOS ROUTINES 



DOS FILE BUFFERS (MAXFILES 3) 




"TOP" OF RAM 



FIGURE 5.1 — DOS MEMORY USE (48K APPLE) 
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THE DOS VECTORS IN PAGE 3 

In addition to the 
approximately 10K of RAM 
occupied by DOS in high 
memory, DOS maintains a group 
of what are called "vectors" 
in page 3 of low memory ($300 
through $3FF) . These vectors 
allow access to certain places 
within the DOS collection of 
routines via a fixed location 
($3D0 for instance) . Because 
DOS may be loaded in various 
locations, depending upon the 
size of the machine and 
whether a slave or master 
diskette is booted, the 
addresses of the externally 
callable subroutines within 
DOS will change. By putting 
the addresses of these 
routines in a vector at a 
fixed location, dependencies 
on DOS ' s location in memory 
are eliminated. The page 3 
vector table is also useful in 
locating subroutines within 
DOS which may not be in the 
same memory location for 
different versions of DOS. 
Locations $300 through $3CF 
were used by earlier versions 
of DOS during the boot process 
to load the Boot 1 program but 
are used by DOS 3.3 as a data 
buffer and disk code translate 
table. Presumably, this 
change was made to provide 
more memory for the first 
bootstrap loader (more on this 
later). The vector table 
itself starts at $3D0. 
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DOS VECTOR TABLE ($3D0-$3FF) 

USAGE 

A JMP (jump or GOTO) instruction to the DOS warmstart 

routine. This routine reenters DOS but does not 

discard the current BASIC program and does not reset 

MAXFILES or other DOS environmental variables. 

A JMP to the DOS coldstart routine. This routine 

reinitializes DOS as if it was rebooted, clearing the 

current BASIC file and resetting HIMEM. 

A JMP to the DOS file manager subroutine to allow a 

user written assembly language program to call it. 

A JMP to the DOS Read/Write Track/Sector (RWTS) 

routine to allow user written assembly language 

programs to call it. 

A short subroutine which locates the input parameter 

list for the file manager to allow a user written 

program to set up input parameters before calling the 

file manager . 

A short subroutine which locates the input parameter 

list for RWTS to allow a user written program to set 

up input parameters before calling RWTS. 

A JMP to the DOS subroutine which "reconnects" the DOS 

intercepts to the keyboard and screen data streams. 

A JMP to the routine which will handle a BRK machine 

language instruction. This vector is only supported by 

the AUTOSTART ROM. Normally the vector contains the 

address of the monitor ROM subroutine which displays 

the registers. 

LO/HI address of routine which will handle RESET for 

the AUTOSTART ROM. Normally the DOS restart address is 

stored here but the user may change it if he wishes to 

handle RESET himself. 

Power-up byte. Contains a "funny complement" of the 

RESET address with a $A5. This scheme is used to 

determine if the machine was just powered up or if 

RESET was pressed. If a power-up occured, the 

AUTOSTART ROM ignores the address at 3F2 (since it has 

never been initialized) and attempts to boot a 

diskette. To prevent this from happening when you 

change $3F2 to handle your own RESETS, EOR (exclusive 

OR) the new value at $3F3 with a $A5 and store the 

result in the power-up byte. 

A JMP to a machine language routine which is to be 

called when the '&' feature is used in APPLESOFT. 

A JMP to a machine language routine which is to be 

called when a control-Y is entered from the monitor. 

A JMP to a machine language routine which is to be 

called when a non-maskable interrupt occurs. 

LO/HI address of a routine which is to be called when 

a maskable interrupt occurs. 
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WHAT HAPPENS DURING BOOTING 

When an APPLE is powered on its memory is 
of any programs. In order to get DOS runn 
"booted". The term "boot" refers to the p 
loading DOS into RAM. Bootstrap loading 
of steps which load successively bigger p 
until all of the program is in memory and 
case of DOS, bootstrapping occurs in four 
location of these stages on the diskette 
are given in Figure 5.2 and a description 
process follows. 



essentially devoid 
ing, a diskette is 
rocess of bootstrap 
involves a series 
ieces of a program 

is running. In the 

stages. The 
and a memory map 

of the bootstrap 



The first boot stage (let's call it Boot 0) is the execution 
of the ROM on the disk controller card. When the user types 
PR#6 or C600G or 6 (ctrl) P, for instance, control is 




DISKETTE 



FIGURE 5.2 - BOOTSTRAP PROCESS 
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transfered to the disk 
controller ROM on the card in 
slot 6. This ROM is a machine 
language program of about 256 
bytes in length. When 
executed, it "recalibrates" 
the disk arm by pulling it 
back to track (the 
"clacketty-clack" noise that 
is heard) and then reads 
sector from track into RAM 
memory at location $800 (DOS 
3.3. Earlier versions used 
$300) . Once this sector is 
read, the first stage boot 
jumps (GOTO's) $800 which is 
the second stage boot (Boot 
1) • 

Boot 1, also about 256 bytes 
long, uses part of the Boot 
ROM as a subroutine and, in a 
loop, reads the next nine 
sectors on track (sectors 1 
through 9) into RAM. Taken 
together, these sectors 
contain the next stage of the 
bootstrap process, Boot 2. 
Boot 2 is loaded in one of two 
positions in memory, depending 
upon whether a slave or a 
master diskette is being 
booted. If the diskette is a 
slave diskette, Boot 2 will be 
loaded 9 pages (256 bytes per 
page) below the end of the DOS 
under which the slave was 
INITed. Thus, if the slave was 
created on a 32K DOS, Boot 2 
will be loaded in the RAM from 
$7700 to $8000. If a master 
diskette is being booted, Boot 
2 will be loaded in the same 
place as for a 16K slave 
($3700 to $4000) . In the 
process of loading Boot 2, 
Boot 1 is loaded a second time 
in the page in memory right 
below Boot 2 ($3600 for a 
master diskette) . This is so 
that, should a new diskette be 
INITed, a copy of Boot 1 will 
be available in memory to be 
written to its track sector 
0. When Boot 1 is finished 
loading Boot 2, it jumps there 
to begin execution of the next 
stage of the bootstrap. 




THE 

BOOT 

PROCESS 
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Boot 2 consists of two parts: a loader "main program"; and 
the RWTS subroutine package. Up to this point there has been 
no need to move the disk arm since all of the necessary 
sectors have been on track 0. Now, however, more sectors 
must be loaded, requiring arm movement to access additional 
tracks. Since this complicates the disk access, RWTS is 
called by the Boot 2 loader to move the arm and read the 
sectors it needs to load the last part of the bootstrap, DOS 
itself. Boot 2 now locates track 2 sector 4 and reads its 
contents into RAM just below the image of Boot 1 (this would 
be at $3500 for a master diskette) . In a loop, Boot 2 reads 
26 more sectors into memory, each one 256 bytes before the 
last. The last sector (track sector A) is read into $1B00 
for a master diskette. The 27 sectors which were read are 
the image of the DOS main routines and the file manager. 
With the loading of these routines, all of DOS has been 
loaded into memory. At this point, the bootstrap process for 
a slave diskette is complete and a jump is taken to the DOS 
coldstart address. If the diskette is a master, the image 
of DOS is only valid if the machine is a 16K APPLE II. If 
more memory is present, the DOS image must be relocated into 
the highest possible RAM present in the machine. To do 
this, the master version of Boot 2 jumps to a special 
relocation program at $1B03. This relocator is 512 bytes in 
length and was automatically loaded as the two lowest pages 
of the DOS image. (In the case of a slave diskette, these 
pages contain binary zeros.) The relocator determines the 
size of the machine by systematically storing and loading on 
high RAM memory pages until it finds the last valid page. It 
then moves the DOS image from $1D00 to its final location 
($9D00 for 48K) and, using tables built into the program, it 
modifies the machine language code so that it will execute 
properly at its new home. The relocator then jumps to the 
high memory copy of DOS and the old image is forgotten. 

The DOS boot is completed by the DOS coldstart routine. This 
code initializes DOS, making space for the file buffers, 
setting HIMEM, building the page 3 vector table, and running 
the HELLO program. 

Previous versions of DOS were somewhat more complicated in 
the implementation of the bootstrap. In these versions, Boot 
1 was loaded at $300 and it, in turn, loaded Boot 2 at 
$3600, as does version 3.3. Unlike 3.3, however, 27 sectors 
of DOS were not always loaded. If the diskette was a slave 
diskette, only 25 sectors were loaded, and, on 13 sector 
diskettes, this meant the DOS image ended either with sector 
8 or sector A of track 2 depending upon whether the diskette 
was a slave or master. In addition. Boot 1 had a different 
form of nibbilization (see chapter 3) than any other sector 
on the diskette, making its raw appearance in memory at 
$3600 non-executable. 

The various stages of the bootstrap process will be covered 
again in greater detail in Chapter 8, DOS PROGRAM LOGIC. 
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CHAPTER 6 

USING DOS FROM ASSEMBLY LANGUAGE 



CAVEAT 

This chapter is aimed at the advanced assembly language 
programmer who wishes to access the disk without resorting 
to the PRINT statement scheme used with BASIC. Accordingly, 
the topics covered here may be beyond the comprehension (at 
least for the present) of a programmer who has never used 
assembly language. 

DIRECT USE OF DISK DRIVE 

It is often desirable or necessary to access the Apple's 
disk drives directly from assembly language, without the use 
of DOS. This is done using a section of 16 addresses that 
are latched toggles, interfacing directly to the hardware. 
There are eight two byte toggles that essentially represent 
pulling a TTL line high or low. Applications which could 
use direct disk access range from a user written operating 
system to DOS-independent utility programs. The device 
address assignments are given in Figure 6.1. 
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ADDRESS 



LABEL 



DESCRIPTION 



$C080 


PHASEOFF 


$C081 


PHASEON 


$C082 


PHASEIOFF 


$C083 


PHASE ION 


$C084 


PHASE 20FF 


$C085 


PHASE 20N 


$C086 


PHASE 30FF 


$C087 


PHASE 30N 


$C088 


MOTOROFF 


$C089 


MOTORON 


$C08A 


DRV EN 


$C08B 


DRV1EN 


$C08C 


Q6L 


$C08D 


Q6H 


$C08E 


Q7L 


$C08F 


Q7H 



Stepper motor pha 
Stepper motor pha 
Stepper motor pha 
Stepper motor pha 
Stepper motor pha 
Stepper motor pha 
Stepper motor pha 
Stepper motor pha 
Turn motor off. 
Turn motor on. 
Engage drive 1. 
Engage drive 2. 
Strobe Data Latch 
Load Data Latch. 
Prepare latch for 
Prepare latch for 



se 





off 


se 





on. 


se 


1 


off 


se 


1 


on. 


se 


2 


off 


se 


2 


on. 


se 


3 


off 


se 


3 


on. 



for I/O. 

input, 
output. 



Q7L with Q6L 
Q7L with Q6H 
Q7H with Q6L 
Q7H with Q6H 



Read 

Sense Write Protect 

Write 

Load Write Latch 



FIGURE 6.1 — DOS HARDWARE ADDRESSES 



The addresses are slot dependent and the offsets are 
computed by multiplying the slot number by 16. In 
hexadecimal this works out nicely and we can add the value 
$s0 (where s is the slot number) to the base address. If we 
wanted to engage disk drive number 1 in slot number 6, for 
example, we would add $60 to $C08A (device address 
assignment for engaging drive 1) for a result of $C0EA. 
However, since it is generally desirable to write code that 
is not slot dependent, one would normally use $C08A,X (where 
the X register contains the value $s0) . 

In general, the above addresses need only be accessed with 
any valid 6502 instruction. However, in the case of reading 
and writing bytes, care must be taken to insure that the 
data will be in an appropriate register. All of the 
following would engage drive number 1. (Assume slot number 
6) 

LDA $C0EA 

BIT $C08A,X (where X-reg contains $60) 

CMP $C08A,X (where X-reg contains $60) 

Below are typical examples demonstrating the use of the 
device address assignments. For more examples, see APPENDIX 
A. Slot 6 is assumed and the X-register contains $60. 
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STEPPER PHASE OFF/ON: 

Basically, each of the four phases (0-3) must be turned on 
and then off again. Done in ascending order, this moves the 
arm inward. In descending order, this moves the arm 
outward. The timing between accesses to these locations is 
critical, making this a non-trivial exercise. It is 
recommended that the SEEK command in RWTS be used to move 
the arm. See the section on using RWTS immediately 
following . 



MOTOR OFF/ON: 



LDA $C088,X 
LDA $C089,X 



Turn motor off, 
Turn motor on. 



NOTE: A sufficient delay should be provided to allow the 
motor time to come up to speed. Shugart recommends one 
second, but DOS is able to reduce this delay by watching the 
»i| read latch until data starts to change. 



ENGAGE DRIVE 1/2: 

LDA $C08A,X 
LDA $C08B,X 



Engage drive 1. 
Engage drive 2. 



^1 READ A BYTE: 



£ 3 



READ 



LDA $C08C,X 
BPL READ 



^NOTE: $C08E,X must already have been accessed to assure Read 

mode. The loop is necessary to assure that the accumulator 

k . _ will contain valid data. If the data latch does not yet 

■I contain valid data the high bit will be zero. 



■I 
3 



SENSE WRITE PROTECT: 

LDA $C08D,X 
LDA $C08E,X 
BMI ERROR 



Sense write protect. 

If high bit set, protected. 



3 WRITE LOAD AND WRITE A BYTE: 



I ^ 

■4 ^ 



m 3 



LDA DATA 
STA $C08D,X 
ORA $C08C,X 



Write load. 
Write byte. 



NOTE: $C08F,X must already have been accessed to insure 
Write mode and a 100 microsecond delay should be invoked 
before writing. 



ml a 
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Due to hardware constraints, data bytes must be written in 
32 cycle loops. Below is an example for an immediate load 
of the accumulator, followed by a write. Timing is so 
critical that different routines may be necessary, depending 
on how the data is to be accessed, and code can not cross 
memory page boundaries without an adjustment. 



LDA #$D5 


(2 cycles) 


JSR WRITE9 


(6) 


LDA #$AA 


(2) 


JSR WRITE9 


(6) 



WRITE9 


CLC 


(2) 


WRITE7 


PHA 


(3) 




PLA 


(4) 


WRITE 


STA $C08D,X 


(5) 




ORA $C08C,X 


(4) 




RTS 


(6) 



CALLING READ/WRITE TRACK/SECTOR (RWTS) 

Read/Write Track/Sector (RWTS) exists in every version of 
DOS as a collection of subroutines, occupying roughly the 
top third of the DOS program. The interface to RWTS is 
standardized and thoroughly documented by Apple and may be 
called by a program running outside of DOS. 

There are two subroutines which must be called or whose 
function must be performed. 



JSR $3E3 - When this subroutine is called 
registers are loaded with the address of 
control Block (IOB) used by DOS when acce 
low order part of the address is in Y and 
part in A. This subroutine should be cal 
IOB and the results may be stored in two 
to allow storing values in the IOB and re 
values after a call to RWTS. Of course, 
own IOB as long as the Y and A registers 
upon calling RWTS. 



, the Y and A 
the Input/Output 
ssing RWTS. The 

the high order 
led to locate the 
zero page locations 
trieving output 
you may set up your 
point to your IOB 



JSR $3D9 - This is the main entry to the RWTS routine. 
Prior to making this call, the Y and A registers must be 
loaded with the address of an IOB describing the operation 
to be performed. This may be done by first calling $3E3 as 
described above. The IOB must contain appropriate 
information as defined in the list on the facing page 
(offsets are given in hexadecimal) : 
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BYTE 

00 

01 

02 

03 

04 

05 

06-07 

08-09 

0A 
0B 
0C 



0D 



0E 
OF 
10 



BYTE 
00 
01 
02-03 



INPUT/OUTPUT CONTROL BLOCK — GENERAL FORMAT 



Example: $60) 



DESCRIPTION 

Table type, must be $01 

Slot number times 16 (sO: s=slot. 

Drive number ($01 or $02) 

Volume number expected ($00 matches any volume) 

Track number ($00 through $22) 

Sector number ($00 through $0F) 

Address (LO/HI) of the Device Characteristics Table 

Address (LO/HI) of the 256 byte buffer for 

READ/WRITE 

Not used 

Byte count for partial sector ($00 for 256 bytes) 



Command code 



Return code 



$00 
$01 
$02 
$04 



SEEK 
READ 
WRITE 
FORMAT 



The processor CARRY flag is set upon 
return from RWTS if there is a 
non-zero return code: 
$00 = No errors 

$08 = Error during initialization 
$10 = Write protect error 
$20 = Volume mismatch error 
$40 = Drive error 
$80 = Read error (obsolete) 
Volume number of last access (must be initialized) 
Slot number of last access*16 (must be initialized) 
Drive number of last access (must be initialized) 

DEVICE CHARACTERISTICS TABLE 

DESCRIPTION 

Device type (should be $00 for DISK II) 

Phases per track (should be $01 for DISK II) 

Motor on time count (should be $EFD8 for DISK II) 



NOTE: RWTS uses zero-page location $48, which is also used 
by the APPLE monitor to hold the P-register value. Location 
$48 should be set to zero after each call to RWTS. 
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RWTS IOB BY CALL TYPE 



SEEK Move disk arm to desired track 

Input: Byte 00 - Table type ($01) 

01 - Slot number * 16 (sO: s=slot) 

02 - Drive number ($01 or $02) 

04 - Track number ($00 through $22) 

06/07 - Pointer to the DCT 

0C - Command code for SEEK ($00) 

OF - Slot number of last access * 16 

10 - Drive number of last access 

Output: Byte 0D - Return code (See previous definition) 

OF - Current Slot number * 16 

10 - Current Drive number 




READ 
Input: 



Read a sector into a specified buffer 

Byte 00 - Table type ($01) 

01 - Slot number * 16 (sO: s=slot) 

02 - Drive number ($01 or $02) 

03 - Volume number ($00 matches any volume) 

04 - Track number ($00 through $22) 

05 - Sector number ($00 through $0F) 
06/07 - Pointer to the DCT 
08/09 - Pointer to 256 byte user data buffer 



Output: 



0B 
0C 
0E 
OF 
10 

Byte 0D 
0E 

OF 
10 



- Byte count per sector ($00) 

- Command code for READ ($01) 

- Volume number of last access 

- Slot number of last access * 

- Drive number of last access 



16 



Return code (See previous definition) 
Current Volume number 
Current Slot number * 16 
Current Drive number 



WRITE 
Input: 



Write a sector from a specified buffer 

Byte 00 - Table type ($01) 

01 - Slot number * 16 (sO: s=slot) 

02 - Drive number ($01 or $02) 

03 - Volume number ($00 matches any volume) 

04 - Track number ($00 through $22) 

05 - Sector number ($00 through $0F) 
06/07 - Pointer to the DCT 

08/09 - Pointer to 256 byte user data buffer 

0B - Byte count per sector ($00) 

0C - Command code for WRITE ($02) 

0E - Volume number of last access 

OF - Slot number of last access * 

10 - Drive number of last access 



m 3 



j =1 

3 



1 



16 



FORMAT Initialize the diskette (does not put DOS on disk, 
create a VTOC/CATALOG , or store HELLO program) 



Input: 



Byte 00 
01 



02 
03 

06/07 
0C 

0E 
OF 
10 



Output: Byte 0D 
0E 
OF 
10 



- Table type ($01) 

- Slot number * 16 (sO: s=slot) 

- Drive number ($01 or $02) 

- Volume number ($00 will default to 254) 

- Pointer to the DCT 

- Command code for FORMAT ($04) 

- Volume number of last access 

- Slot number of last access * 16 

- Drive number of last access 

- Return code (See previous definition) 

- Current Volume number 

- Current Slot number * 16 

- Current Drive number 



CALLING THE DOS FILE MANAGER 



The DOS file manager 
collection of subrout 
central third of the 
routines is generaliz 
called by a program r 
of this interface has 
anyone else, for that 
made through fixed ve 
lists passed have not 
these routines may be 
FID utility program u 
the diskette. 



exists in every version of DOS as a 
ines occupying approximately the 
DOS program. The interface to these 
ed in such a way that they may be 
unning outside of DOS. The definition 
never been published by APPLE (or 
manner) but since the calls can be 
ctors, and, the format of the parameter 
changed in all the versions of DOS, 
relied upon as "safe". Indeed, the new 
ses these routines to process files on 



Output: 
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Byte 0D - Return code (See previous definition) 

0E - Current Volume number 

OF - Current Slot number * 16 

10 - Current Drive number 



There are two subroutines which must be called in order to 
access the file manager . 

JSR $3DC - When this subroutine is called, the Y and A 
registers are loaded with the address of the file manager 
parameter list. The low order part of the address is in Y 
and the high order part in A. This subroutine must be called 
at least once to locate this parameter list and the results 
may be stored in two zero page locations to allow the 
programmer to set input values in the parameter list and to 
locate output values there after file manager calls. 

JSR $3D6 - This is the main entry to the file manager. Prior 
~ *j| to making this call the parameter list, located using the 

call described above, must be completed appropriately, 
-^ depending upon the type of call, and the X register must be 
-£3 set to either zero or non-zero as follows: 

M X = - If file is not found, allocate it 

X # - If file is not found, do not allocate one 

new file 



Normally, X should be zero on an OPEN call for a 
and non-zero for all other call types. 



mka 
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Three buffers must 
programmer, alloca 
together , occupy 5 
file manager each 
separate set of th 
open file. DOS ma 
described in earli 
may be "borrowed 
about it. A method 



be provided to the file manager by the 
ted by him in his memory. These buffers, 
57 bytes of RAM, and must be passed to the 
time their associated file is used. A 
ese buffers must be maintained for each 
intains buffers for this purpose, as 
er chapters, in high RAM. These buffers 
from DOS if care is taken to let DOS know 

for doing this will be outlined later. 



^ 



A chart giving the required inputs for each call type to the 
file manager is given in Figure 6.2. The general format of 
the file manager parameter list is as follows: 

FILE MANAGER PARAMETER LIST - GENERAL FORMAT 



BYTE 


DESCRIPTION 






00 


Call type: 01=OPEN 


05=DELETE 


09=RENAME 




2=CLOSE 


06=CATALOG 


0A=POSITION 




03=READ 


07=LOCK 


0B=INIT 




4=WRITE 


08=UNLOCK 


0C=VERIFY 



01 Sub-call type for READ or WRITE: 

00=No operation (ignore call entirely) 
01=READ or WRITE one byte 
02=READ or WRITE a range of bytes 
03=POSITION then READ or WRITE one byte 
04=POSITION then READ/WRITE a range 
02-09 Parameters specific to the call type used. See 

FILE MANAGER PARAMETER LIST BY CALL TYPE below. 
0A Return code (note: not all return codes can occur 
for any call type) . The processor CARRY 
flag is set upon return from the file 
manager if there is a non-zero return code: 
00=No errors 

01=Not used ("LANGUAGE NOT AVAILABLE") 
02=Bad call type 

03=Bad sub-call type (greater than four) 
04=WRITE PROTECTED 
05=END OF DATA 

06=FILE NOT FOUND (was allocated if X=0) 
07=VOLUME MISMATCH 
08=DISK I/O ERROR 
09=DISK FULL 
0A=FILE LOCKED 
0B Not used 

0C-0D Address of a 45 byte buffer which will be used by the 
file manager to save its status between calls. This 
area is called the file manager workarea and need not 
be initialized by the caller but the space must be 
provided and this two byte address field initialized, 
(addresses are in low/high order format) 
0E-0F Address of a 256 byte buffer which will be used by the 
file manager to maintain the current Track/Sector List 
sector for the open file. Buffer itself need not be 
initialized by the caller. 
10-11 Address of a 256 byte buffer which will be used by the 
file manager to maintain the data sector buffer. 
Buffer need not be initialized by the caller. 
6-8 
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00 


01 


. 


03 


04 


OS 


Of 


07 


- 


. 


0A 


0B 


OC | 0D 


- 


OF 


10 


11 


OPIN 


01 




RECORD 
LENGTH 
OR 0000 


V 


D 


s 


FILE 
TYPE 


FILE 

NAME 

ADDRESS 


P 

D 
£ 

b 
o 
in 

a 

O 


z 

K 

i 

a 




ADDR. OF 

FILE 

MANAGER 

WORK 

AREA 

BUFFER 


ADDR. OF 
T/SUST 
BUFFER 






CLOSE 


02 






















DATA 

SECTOR 
BUFFER 
ADDRESS 




03 


s 

u 

B 
C 
O 
D 

E 


RECORD 

NUMBER 


BYTE 
OFFSET 


RANGE 
LENGTH 








READ 


ONE 
DATA 
BYTE 


RANGE 
ADDR. 




04 




WRITE 






DELETE 


OS 








V 


D 


S 




FILE 

NAME 

ADDRESS 








CATALOG 


OS 










D 


S 


















LOCK 


07 








V 


D 


S 




FILE 

NAME 

ADDRESS 




T/S 

LIST 

ADDRESS 






UNLOCK 


00 








V 


D 


s 










RENAME 


OS 




NEW NAME 
ADDRESS 


V 


D 


s 










POSITION 


0A 




RECORD 

NUMBER 


BYTE 
OFFSET 




















INIT 


OS 


DOS 
PAGE 
NO. 






V 


D 


s 


















VERIFV 


oc 








V 


D 


s 




FILE 

NAME 

ADDRESS 




T/S LIST 
ADDRESS 


DATA BUFF. 

ADDRESS 



FIGURE 6.2 — FILE MANAGER PARAMETER LIST 
REQUIRED INPUT 




CALLING TUE FILE MANAGER 
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FILE MANAGER PARAMETER LIST BY CALL TYPE 



OPEN Locates or creates a file. A call to POSITION should 
follow every OPEN. 



Input: Byte 



00 - 01 

02/03 - Fixed record length or 0000 if variable 

04 - Volume number or 00 for any volume 

05 - Drive number to be used (01 or 02) 

06 - Slot number to be used (01-07) 

07 - File type (used only for new files) 

$00 = TEXT 

$01 = INTEGER BASIC 

$02 = APPLESOFT BASIC 

$04 = BINARY 

$08 = RELOCATABLE 

$10 = S TYPE FILE 

$20 = A TYPE FILE 

$40 = B TYPE FILE 
08/09 - Address of file name 

(Low/high format) 
0C/0D - Address of file manager workarea buffer 
0E/0F - Address of T/S List sector buffer 
10/11 - Address of data sector buffer 



[30 characters) 



Output: Byte 07 
0A 



File type of file which was OPENed 
Return code (see previous definitions) 



CLOSE Write out final sectors, update the Catalog. 

A CLOSE call is required eventually for every OPEN. 

Input: Byte 00 - 02 

0C/0D - Address of file manager workarea buffer 
0E/0F - Address of T/S List sector buffer 
10/11 - Address of data sector buffer 



Output: Byte 0A 



Return code 



READ Read one or a range of bytes from the file to memory. 
WRITE Write one or a range of bytes from memory to the file 



Input: Byte 



00 
01 



02/03 
04/05 
06/07 



03 (READ) 04 (WRITE) 
Subcode : 

00 = No operation 

01 = READ or WRITE one byte only 

02 = READ or WRITE a range of bytes 

03 = POSITION then READ/WRITE one byte 

04 = POSITION then READ/WRITE range 
(Subcodes 03 or 04) Record number 
(Subcodes 03 or 04) Byte offset 
(Subcodes 02 or 04) Number of bytes in 
range to be read or written. (Note: for 
WRITE, this length must be one less 
than the actual length to be written) 
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08/09 - (Subcodes 02 or 04) Address of range of 
bytes to be written or address of 
buffer to which bytes are to be read. 
08 - (WRITE, Subcodes 01 or 03) Single byte 

to be written. 
0C/0D - Address of file manager workarea buffer 
0E/0F - Address of T/S List sector buffer 
10/11 - Address of data sector buffer 

Output: Byte 02/03 - Record number of current file position 
04/05 - Byte offset of current file position* 
08 - (READ, Subcodes 01 or 03) Byte read 
0A - Return code 

*The current file position is updated to point to the byte 
following the data read or written. 



DELETE Locate and delete a file, freeing its sectors. 

Input: Byte 00 - 05 

(remainder are the same as with OPEN call type) 



Output: Byte 0A - Return code 



CATALOG Produce a catalog listing on the output device. 

Input: Byte 00 - 06 

5 - Drive 

06 - Slot 

0C/0D - Address of file manager workarea buffer 



Output: Byte 0A 



Return code 



LOCK Lock a file. 

Input: Byte 00 - 07 

(remainder are the same as with OPEN call type) 



Output: Byte 0A 



Return code 



UNLOCK Unlock a file. 

Input: Byte 00 - 08 

(remainder are the same as with OPEN call type) 



Output: Byte 0A 



Return code 



RENAME Rename a file. 

Input: Byte 00 - 09 

02/03 - Address of new file name (30 bytes) 
(remainder are the same as with OPEN call type) 



Output: Byte 0A 



Return code 
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POSITION Calculate the location of a record and/or byte 

offset in the file. Position such that next READ or 
WRITE will be at that location in the file. A call 
to POSITION (either explicitly or implictly using 
subcodes of READ or WRITE) is required prior to the 
first READ or WRITE. Bytes 02 through 05 should be 
set to zeros for a normal position to the beginning 
of the file. 






Input: Byte 00 - 0A 

02/03 - Relative record number for files with a 
fixed length record size or zero. First 
record of file is record 0000. 

04/05 - Relative byte offset into record or of 
entire file if record number is zero. 

0C/OD - Address of file manager workarea buffer. 

Output: Byte 0A - Return code 






INIT Initialize a slave diskette. This function formats a ^ 
diskette and writes a copy of DOS onto tracks 0-2. 
A VTOC and Catalog are also created. A HELLO program ^, 
is not stored, however. C 



Input: Byte 




01 



04 
05 
06 
0C/0D 



Output: Byte 0A 



0B 

First page of DOS image to be copied to 

the diskette. Normally $9D for a 48K 

machine . 

Volume number of new diskette. 

Drive number (01 or 02) 

Slot number (01-07) 

Address of file manager workarea buffer. 

Return code 



I* 



VERIFY Verify that there are no bad sectors in a file by 
reading every sector. 

Input: Byte - 0C 

(remainder are the same as the OPEN call type) 



Output: Byte 0A 



Return code 
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DOS BUFFERS 

Usually it is desirable to use one of DOS ' s buffers when 
calling the file manager to save memory. DOS buffers consist 
of each of the three buffers used by the file manager (file 
manager workarea, T/S List sector, and data sector) as well 
as a 30 byte file name buffer and some link pointers. All 
together a DOS buffer occupies 595 bytes of memory. The 
address of the first DOS buffer is stored in the first two 
bytes of DOS ($9D00 on a 48K APPLE II) . The address of the 
next buffer is stored in the first and so on in a chain of 
linked elements. The link address to the next buffer in the 
last buffer is zeros. If the buffer is not being used by 
DOS, the first byte of the file name field is a hex 00. 
Otherwise, it contains the first character of the name of 
the open file. The assembly language programmer should 
follow these conventions to avoid having DOS reuse the 
buffer while he is using it. This means that the name of the 
file should be stored in the buffer to reserve it for 
exclusive use (or at least a non-zero byte stored on the 
first character) and later, when the user is through with 
the buffer, a 00 should be stored on the file name to return 
it to DOS's use. If the later is not done, DOS will 
eventually run out of available buffers and will refuse even 
to do a CATALOG command. A diagram of the DOS buffers for 
MAXFILES 3 is given in Figure 6.3 and the format of a DOS 
buffer is given below. 



3 

■a 



DOS BUFFER FORMAT 

BYTE DESCRIPTION 

000/0FF Data sector buffer (256 bytes in length) 

100/1FF T/S List sector buffer (256 bytes in length) 

200/22C File manager workarea buffer (45 bytes in length) 

22D/24A File name buffer (30 bytes in length) 

First byte indicates whether this DOS buffer is 
being used. If hex 00, buffer is free for use. 

24B/24C Address (Lo/High) of file manager workarea buffer 

24D/24E Address of T/S List sector buffer 

24F/250 Address of data sector buffer 

251/252 Address of the file name field of the next buffer on 
the chain of buffers. If this is the last buffer on 
the chain then this field contains zeros. 
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DOS 



BUFFER 

#1 



BUFFER 

#2 



BUFFER 

#3 



CHAIN POINTERS 

FILE NAME BUFFER 

FILE MANAGER WORKAREA BUFFER 

T/S LIST SECTOR BUFFER 



DATA SECTOR BUFFER 



< HIMEM 
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FIGURE 6.3— DOS FILE BUFFERS 
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THE FILE MANAGER WORKAREA 

The file manager workarea contains th 
taken together, constitute all of the 
manager needs to deal with an open fi 
manager finishes processing a call, i 
important variables into the file man 
provided by the caller. Each subseque 
manager is called, the first thing it 
contents of the file manager workarea 
variables so that it may resume proce 
where it left off on the previous cal 
programmer will have no need to worry 
this workarea, since most of the usef 
present in the parameter list anyway, 
handy to know more about the open fil 
format of the file manager workarea i 



e variables which, 
information the file 

le. Each time the file 

t copies all of its 

ager workarea buffer 

nt time the file 
does is to copy the 
buffer back into its 

ssing for the file 

1. Ordinarily, the 
about the contents of 

ul information is 
Occasionally, it is 

e. For these cases, the 

s given below: 



FILE MANAGER WORKAREA FORMAT 

BYTE DESCRIPTION 

00/01 Track/Sector of first T/S List for file 

02/03 Track/Sector of current T/S List for file 

04 Flags: 

80=T/S List buffer changed and needs writing 
40=Data buffer has been changed and needs writing 
02=Volume freespace map changed and needs writing 

05/06 Track/Sector of current data sector 

07 Sector offset into catalog to entry for this file 

08 Byte offset into catalog sector to entry for file 
09/OA Maximum data sectors represented by one T/S List 
0B/0C Offset of first sector in current T/S List 
0D/0E Offset of last sector in current T/S List 

0F/10 Relative sector number last read 

11/12 Sector size in bytes (256) 

13/14 Current position in sectors (relative) 

15 Current byte offset in this sector 

16 Not used 

17/18 Fixed record length 

19/1A Current record number 

1B/1C Byte offset into current record 

ID/IE Length of file in sectors 

IF Next sector to allocate on this track 

20 Current track being allocated 

21/24 Bit map of available sectors on this track (rotated) 

25 File type (80 = locked) ,1 , 2 , 4=T, I ,A,B 

26 Slot number times 16 (example: $60=slot 6) 

27 Drive number (01 or 02) 

28 Volume number (complemented) 

29 Track 
2A/2C Not used 
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COMMON ALGORITHMS 

Given below are several pieces of code which are used when 
working with DOS: 

LOCATE A FREE DOS BUFFER 

The following subroutine may be used to locate an 
unallocated DOS buffer for use with the DOS file manager. 



FBUFF 



GBUFO 



LDA 
STA 
LDY 
STY 

LDA 
PHA 
INY 
LDA 
STA 
PLA 
STA 
BNE 
LDA 
BEQ 

LDY 
LDA 
BEQ 
LDY 
BNE 



GOTBUF CLC 
RTS 

NBUF SEC 
RTS 



LOCATE DOS LOAD POINT 



$3D2 
$1 

#0 
$0 



($0) ,Y LOCATE NEXT DOS BUFFER 



($0) ,Y 
$1 



GBUF 



$0 
GBUF 

$1 
NBUF 

#0 

($0) ,Y 
GOTBUF 
#36 
GBUFO 



GOT ONE 

NO BUFFERS FREE 

GET FILENAME 

ITS FREE 

ITS NOT FREE 

GO GET NEXT BUFFER 

INDICATE-GOT A FREE BUFFER 
RETURN TO CALLER 
INDICATE-NO FREE BUFFERS 
RETURN TO CALLER 



WHICH VERSION OF DOS IS ACTIVE? 

In case the program has version dependent code, a check of 
the DOS version may be required: 



ADD $16BE TO DOS LOAD POINT 



CLC 




LDA 


#0 


ADC 


#$BE 


STA 


$0 


LDA 


$3D2 


ADC 


#$16 


STA 


$1 


LDY 


#0 


LDA 


($0) 



,Y GET DOS VERSION NUMBER (2 OR 3) 



1 

fe i 
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IS DOS IN THE MACHINE? 

The following series of instructions should be used prior to 
^ attempting to call RWTS or the file manager to insure that 
2l DOS is present on this machine. 

*| WHICH BASIC IS SELECTED? 

-« Some programs depend upon either the INTEGER BASIC ROM or 
!8 the APPLESOFT ROM. To find out which is active and select 

the one desired, the following subroutine can be called. 
«| First the A register is loaded with a code to indicate which 
BASIC is desired. $20 is used for INTEGER BASIC and $4C is 
used for APPLESOFT. To set up for APPLESOFT, for example: 



LDA 


$3D0 


GET VECTOR JMP 


CMP 


#$4C 


IS IT A JUMP? 


BNE 


NODOS 


NO, DOS NOT LOADED 



fc 

E 



3 
3 



LDA 
JSR 
BNE 



■I SETBSC CMP 
BEQ 
^ STA 

■S CMP 

BEQ 
W l I) STA 



m-> 3 



RTS 



CMP 
RTS 



#$4C CODE FOR APPLESOFT 

SETBSC CALL SUBROUTINE 

ERROR LANGUAGE NOT AVAILABLE 



$EO00 CORRECT BASIC ALREADY THERE? 

RTS YES 

$C080 NO, SELECT ROM CARD 

$E000 NOW DO WE HAVE IT? 

RTS YES 

$C081 NO, TRY ROM CARD OUT 

$E000 GOT IT NOW? 

IN ANY CASE, EXIT TO CALLER 



3 SEE IF A BASIC PROGRAM IS IN EXECUTION 

To determine if there is a BASIC program running or if BASIC 
3j is in immediate command mode, use the following statements: 
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3 
A 



.IF INTEGER BASIC IS ACTIVE... 
LDA $D9 

BMI EXEC PROGRAM EXECUTING 

BPL NOEXEC PROGRAM NOT EXECUTING 

, IF APPLESOFT BASIC IS ACTIVE... 

GET LINE NUMBER 

PROGRAM NOT EXECUTING 

GET PROMPT CHARACTER 

PROMPT IS A "] "? 

YES, NOT EXECUTING 

ELSE, PROGRAM IS EXECUTING 



LDX 


$76 


INX 




BEQ 


NOEXEC 


LDX 


$33 


CPX 


#$DD 


BEQ 


NOEXEC 


BNE 


EXEC 
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51 CHAPTER 7 

^ j ^ CUSTOMIZING DOS 

i S 

C *i Although DOS usually provides most of the functionality 

needed by the BASIC or assembly language programmer , at 
^ j times a custom change is required. Making changes to your 
™ 51 CO py of DOS should only be undertaken when absolutely 

necessary, since new versions of DOS are released from time 
£■ i ^J to time, and the job of moving several patches to a new 

version of DOS every few months can become a burden. In 
fc -_ addition, wholesale modification of DOS without a clear 
^ 51 understanding of the full implications of each change can 

result in an unreliable system. 

a SLAVE VS MASTER PATCHING 

fe i S| The usual procedure for making changes to DOS involves 

"patching" the object or machine language code in DOS. Once 

^ -_ a desired change- is identified, a few instructions are 

C 3 stored over other instructions within DOS to modify the 

program. There are three levels at which changes to DOS may 

te 3| be applied. 

1 - A patch can be made to the DOS in memory. If this is 
J*; i a| done, a later reboot will cause the change to "fall out" or 
be removed. 

■J 2 - A patch of the first type can be made permanent by 

initializing a diskette while running the patched DOS. This 
procedure creates a slave diskette with a copy of DOS on 
tracks 0, 1, and 2 which contains the patch. Each time this 
newly created diskette is booted the patched version of DOS 

■j will be loaded. Also, any slave diskettes created by that 
diskette will also contain the patched version of DOS. 



3 



^ 3 - The patch is applied directly to a master diskette. This 
is somewhat more complicated. Either the patch may be made 

>:M to the image of DOS on the first three tracks of a master 
diskette using a zap program, or MASTER CREATE may be used 

-~ to write the changed copy of DOS to a new diskette. The 

13 following procedure may be followed to do this: 
BLOAD MASTER CREATE 
^M Get into the monitor (CALL -151) 

3 Store a $4C at location $80D (80D:4C) 
Execute MASTER CREATE (800G) 
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When MASTER CREATE finishes loading the DOS image 
it will exit. You may use the monitor to make 
changes in the image. MASTER CREATE loads DOS 
into memory at $1200 such that Boot 2 (RWTS) is 
loaded first, followed by the main part of DOS 
starting at $1C00. 

When all patches have been made, reenter MASTER CREATE 
at location $82D (82DG) . 

Complete the MASTER CREATE update normally. The 

resulting diskette will have the patches applied. 
This procedure will work for versions 3.2, 3.2.1, and 3.3 of 
DOS. 
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CUSTOMIZING 
DOS 




AVOIDING RELOAD OF LANGUAGE CARD 

A rather annoying addition to DOS 3.3 was a patch to the 
Boot 2 code to store a binary zero in the first byte of the 
language card, forcing DOS to reload BASIC (either INTEGER 
or APPLESOFT) for every boot, whether or not the machine was 
just powered up. When the machine is first powered up this 
patch is not necessary, because the first byte of the 
language card does not appear to DOS to be either BASIC, and 
the card will always be loaded. On subsequent reboots, more 
often than not a good copy of BASIC already resides in the 
language card and this patch results in a LANGUAGE NOT 
AVAILABLE error message after booting a slave diskette. 
Presumably the patch was added to version 3.3 to allow for 
the possibility that a future language might have a first 
byte of code that matched one of the BASICS, thus confusing 
DOS and causing unknown results. If the user always powers 
the machine off and on when switching from DOS to some other 
operating system (i.e., PASCAL or CP/M), the patch may be 
removed as follows. 

At $BFD3 (48K) is a STA instruction which stores a zero on 
the language card. This instruction must be changed to 
three no-operation instructions: 

BFD3:EA EA EA 
7-2 
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A slave diskette may then be INITed using this modified 
version of DOS and that diskette will not reload BASIC when 
booted. A master diskette may be patched in this manner and 
will create the desired result on an original Apple or an 
Apple lie. In the case of an Apple II Plus, however, the 
HELLO file on a master diskette will always reload the 
language card anyway. 

INSERTING A PROGRAM BETWEEN DOS AND ITS BUFFERS 

Once in a while it is useful to find a "safe" place to load 
a machine language program (a printer driver, perhaps) where 
BASIC and DOS can never walk over it, even if DOS is 
coldstarted. If the program is less than 200 bytes long, 
$300 is a good choice. For larger programs, it is usually 
better to "tuck" the program in between DOS and its buffers 
(assuming the program is relocatable and will run at that 
location). To do this, load the program into low RAM, copy 
it to high RAM right below $9D00 (for a 48K machine) , over 
the top of DOS's buffers, change the first buffer address at 
$9D00 to point below your program, (remember to allow 38 
extra bytes for the filename and link fields) and JMP to 
$3D3 (DOS COLDSTART) . This will cause DOS to rebuild its 
buffers below your program and "forget" about the memory 
your program occupies until the next time DOS is booted. Of 
course, BASIC can not get at that memory either, since its 
HIMEM is below the DOS buffers. 

BRUN OR EXEC THE HELLO FILE 

Ordinarily, when DOS finishes booting into memory, it 
performs a RUN command on the HELLO file in its file name 
buffer (left there by the INIT command which wrote DOS to 
the diskette) . To change the RUN command to a BRUN or an 
EXEC, apply the following patch to DOS (48K) : 

9E42:34 (for BRUN) ..or.. 9E24:14 (for EXEC) 

REMOVING THE PAUSE DURING A LONG CATALOG 

Normally, when a CATALOG command is done on a disk with many 
files, DOS will pause every time the screen fills with names 
to allow the user time to see them all. By pressing any key 
the CATALOG continues. If this pause is undesirable, apply 
the following patch to DOS (48K) : 

AE34:60 

CHANGING THE HELLO FILE NAME 

You can change the name of the HELLO file by changing the 
contents of DOS's primary file name buffer. For example, to 
change the primary file name from HELLO to HI THERE, the 
oatch is (48K) : 

AA75:C8 C9 AO D4 C8 C5 D2 C5 
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PUT CURSOR ON COMMAND THAT CAUSED DOS ERROR 

When you get a DOS error message such as "FILE NOT FOUND" or 
"FILE TYPE MISMATCH" because you typed the wrong file name 
or misspelled it slightly, it would be nice if DOS would 
return the cursor to the line with your faulty command so 
you could more easily retype it. To make DOS do this from 
now on, apply the following patches (48K). 

A6FF:4C DF BC (was 6C 5E 9D) 

and 
BCDF:C6 25 C6 25 C6 25 C6 25 20 22 FC 6C 5E 9D 

This patch causes a jump to some new logic at $BCDF, an 
unused area of RWTS . 



ALLOW THE VALUE OF THE L KEYWORD 
OF A BSAVE TO EXCEED 32K 

This patch allows you to save more than 32K with the BSAVE 
command. It simply involves changing one byte from 7F to 
FF. Apply the following patch (48K): 

A964:FF 



UPDATING PRE-1983 DOS 3.3 

Minor revisions to DOS 3.3 were made in early January, 1983. 
These revisions are explained on pages 2-4 and 8-41. If you 
have an earlier version of DOS 3.3 and wish to update it to 
the latest version, poke in these changes and then save DOS 
using method 2 or 3 on page 7-1. The following changes are 
for a 48K system. 

A6BB:20 69 BA 

B33E:18 AD BF B5 8D EC B5 6D E6 B5 8D E6 B5 AD CO B5 

:8D ED B5 6D E4 B5 8D E4 B5 90 03 EE E5 B5 60 00 00 

B684:84 BA 

B6AA:BB 

BA69:AE 5F AA E0 1C F0 05 A2 00 8E 5D B6 60 A9 FF 8D 
:FB 04 8D 0C CO 8D 0E CO 4C 2F FB AD BD B5 8D E6 
:B5 8D EA B5 BA 8E 9B B3 4C 7F 00 00 

BFD6.-20 76 BA 4C 44 B7 
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CHAPTER 8 

DOS PROGRAM LOGIC 
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will take a detailed look at the operation of 
am itself to aid the APPLE user in 

it and to help him to make intelligent use of 
s. Each subroutine and group of variables or 
1 be covered separately by storage address. The 
programmer may wish to create a disassembly of 
inter and transfer the annotations given here 
uch a listing. Addresses used will be for DOS 

48K master diskette version of DOS. Slot 6 is 
ss specifically indicated by a $ character, 
iven in decimal, addresses in hexadecimal (base 



DISK II CONTROLLER CARD ROM — BOOT 

ADDRESS 

C600-C65B This routine is the first code executed when a disk 
is to be booted. It receives control via PR#6 or 
C600G or 6 control-P. 

Dynamically build a translate table for converting 
disk codes to six bit hex at location $356-$3FF. 
Call an RTS instruction in the monitor ROM and 
extract the return address from the stack to find out 
the address of this controller card ROM. 
Use this address to determine the slot number of this 
drive by shifting $Csxx. 
Save the slot number times 16 ($s0) 

Clear disk I/O latches, set read mode, select drive 
1, turn disk drive on. 

Pull disk arm back over 80 tracks to recalibrate the 
arm to track zero. 

Set up parms to read sector zero on track zero to 
location $800. 

Execution falls through into a general sector read 
subroutine at C65C. 

C65C-C6FA This subroutine reads the sector number stored at 
$3D on the track indicated by $41 to the address 
stored at $26, $27. 

Look for D5/AA/96 sector address header on the disk. 
If D5/AA/AD is found and sector data was wanted, go 
to C6A6. 

8-1 
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C683 Handle a sector address block. 

Read three double bytes from the disk and combine 

them to obtain the volume, track, and sector number 

of the sector being read from the disk at this time. 

Store the track at $40. 

Compare the sector found to the sector wanted and the 

track found to the track wanted. 

If no match, go back to C6 5C. 

Otherwise, if sector is correct, go to C65D to find 

the sector data itself. 

C6A6 Handle sector data block. 

Read the 85 bytes of secondary data to $300-$355. 

Read 256 bytes of primary data to the address stored 

at $26, $27. 

Verify that the data checksum is valid. 

If not, start over at C65C. 

"Nibbilize" the primary and secondary data together 

into the primary data buffer ($26, $27). 

Increment $27 (address page of read data) and $3D 

(sector number to be read) and check against $800 

to see if additional sectors need to be read. 

If so, reload slot*16 and go back to C65C to read 

next sector. (This feature is not used when loading 

DOS but is used when loading from a BASICS diskette.) 

Otherwise, go to $801 to begin executing the second 

stage of the bootstrap. 
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FIRST RAM BOOTSTRAP LOADER - BOOT 1 

ADDRESS 

0801-084C This routine loads the second RAM loader, Boot 2, 
including RWTS, into memory and jumps to it. 
If this is not the first entry to Boot 1, go to $81F. 
Get slot* 16 and shift down to slot number. 
Create the address of the ROM sector read subroutine 
(C65C in our case) and store it at $3E,$3F. 
Pick up the first memory page in which to read Boot 2 
from location $8FE, add the length of Boot 2 in 
sectors from $8FF, and set that value as the first 
address to which to read (read last page first) . 

081F Get sector to read, if zero, go to $839. 

Translate theoretical sector number into physical 
sector number by indexing into skewing table at $84D. 
Decrement theoretical sector number (8FF) for next 
iteration through. 

Set up parameters for ROM subroutine (C65C) and 
jump to it. It will return to $801 when the sector 
has been read. 

0839 Adjust page number at 8FE to locate entry point of 
Boot 2. 

Perform a PR#0 and IN#0 by calling the monitor. 
Initialize the monitor (TEXT mode, standard window, 
etc.) 

Get slot*16 again and go to Boot 2 ($3700 for a 
master disk, $B700 in its final relocated location). 

DOS 3.3 MAIN ROUTINES 

ADDRESS 

9D00-9D0F Relocatable address constants 



9D00 
9D02 
9D04 
9D06 
9D08 
9D0A 
9D0C 
9D0E 



Address of 
Address of 
Address of 
Address of 
Address of 
Address of 
Address of 
Address of 



first DOS buffer at its file name field. 

the DOS keyboard intercept routine. 

the DOS video intercept routine. 

the primary file name buffer. 

the secondary (RENAME) file name buffer. 

the range length parameter used for LOAD. 

the DOS load address ($9D00) . 

the file manager parameter list. 



9D10-9D1C DOS video (CSWL) intercept's state handler address 
table. States are used to drive the handling of DOS 
commands as they appear as output of PRINT statements 
and this table contains the address of the routine 
which handles each state from state to state 6. 
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9D1E-9D55 Command handler entry point table. This table 

contains the address of a command handler subroutine 
for each DOS command in the following standard order: 



INIT 


A54F 


LOAD 


A413 


SAVE 


A397 


RUN 


A4D1 


CHAIN 


A4F0 


DELETE 


A263 


LOCK 


A271 


UNLOCK 


A275 


CLOSE 


A2EA 


READ 


A51B 


EXEC 


A5C6 


WRITE 


A510 


POSITION 


A5DD 


OPEN 


A2A3 


APPEND 


A298 


RENAME 


A281 


CATALOG 


A56E 


MON 


A233 


NOMON 


A23D 


PR# 


A229 


IN# 


A22E 


MAXFILES 


A251 


FP 


A57A 


INT 


A59E 


BSAVE 


A331 


BLOAD 


A35D 


BRUN 


A38E 


VERIFY 


A27D 



9D56-9D61 Active BASIC entry point vector table. The addresses 
stored here are maintained by DOS such that they 
apply to the current version of BASIC running. 

9D56 Address of CHAIN entry point to BASIC. 

9D58 Address of RUN. 

9D5A Address of error handler. 

9D5C Address of BASIC coldstart. 

9D5E Address of BASIC warmstart. 

9D60 Address of BASIC relocate (APPLESOFT only) . 

9D62-9D6B Image of the entry point vector for INTEGER BASIC. 

This image is copied to 9D56 if INTEGER BASIC is made 
active . 

9D6C-9D77 Image of the entry point vector for the ROM version 
of APPLESOFT. 

9D78-9D83 Image of the entry point vector for the RAM version 
of APPLESOFT. 

9D84-9DBE DOS coldstart entry routine. 

Get the slot and drive numbers and store as default 

values for command keywords. 

Copy APPLESOFT ROM or INTEGER BASIC entry point 

vector into current BASIC entry point vector. 

Remember which BASIC is active. 

Go to 9DD1. 
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9DBF-9DE9 DOS warmstart entry routine. 

Get the remembered BASIC type and set the ROM card 
as necessary (calls A5B2) . 
9DD1 Remember whether entry is coldstart or warmstart 
Call A851 to replace DOS keyboard and video 
intercepts . 
Set NOMON C,I,0. 

Set video intercept handler state to 0. 
Coldstart or warmstart the current BASIC (exit DOS) . 
(DOS will next gain control when BASIC prints its 
input prompt character) 

-9E50 First entry processing for DOS. This routine is 

called by the keyboard intercept handler when the 

first keyboard input request is made by BASIC after 

a DOS coldstart. 

If RAM APPLESOFT is active, copy its entry point 

vector to the active BASIC entry point vector and 

blank out the primary file name buffer so that no 

HELLO file will be run. 

Set MAXFILES to 3 by default. 

Call A7D4 to build the DOS file buffers. 

If an EXEC was active, close the EXEC file 

Set the video intercept state to and indicate 

warmstart status by calling A75B. 

If the last command executed was not INIT (this DOS 

was not just booted) , go to 9E45. 

Otherwise, copy an image of the DOS jump vector to 

$3D0-$3FF. 

Point $3F2,$3F3 to DOS warmstart routine. 

Set the AUTOSTART ROM power-up byte since the RESET 

handler address was changed. 

Set the command index for RUN (to run the HELLO file) 

and go to A180 to execute it. 
9E45 See if there is a pending command. 

If so, go to A180 to execute it. Otherwise, return 

to caller. 

9E51-9E7F An image of the DOS page 3 jump vector which the 

above routine copies to $3D0-$3FF. See Chapter 5 for 
a description of its contents. 
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9E81-9EB9 DOS keyboard intercept routine. 

Call 9ED1 to save the registers at entry to DOS. 
If not coldstarting or reading a disk file, 
go to 9E9E. 

Get value in A register at entry and echo it on the 
screen (erases flashing cursor) . 

If in read state (reading a file) go to A626 to get 
next byte from disk file. 

Otherwise, call 9DEA to do first entry processing. 
Put cursor on scr.een in next position. 
9E9E if EXECing, call A682 to get the next byte from the 
EXEC file. 

Set the video intercept state to 3 (input echo) . 
Call 9FBA to restore the registers at entry to DOS. 
Call the true keyboard input routine. 
Save the input character so that it will be restored 
with the registers in the A register. 
Do the same with the new X register value. 
Exit DOS via 9FB3. 
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9EBA-9EBC A jump to the true KSWL handler routine. 

9EBD-9ED0 DOS video intercept routine. 

Call 9ED1 to save the registers at entry to DOS. 
Get the video intercept state and, using it as an 
index into the state handler table (9D10) , go to 
the proper handler routine, passing it the character 
being printed. 

9ED1-9EEA Common intercept save registers routine. 

Save the A, X, Y, and S registers at AA59-AA5C. 
While in DOS, restore the true I/O handlers (KSWL and 
CSWL) to $36-$39. 
Return to caller. 

9EEB-9F11 State output handler. — start of line-- 

If a RUN command was interrupted (by loading RAM 

APPLESOFT) go to 9F78 to complete it. 

If read flag is on (file being read) and output is a 

"?" character (BASIC INPUT) , go to state 6 to skip 

it. 

If read flag is on and output is prompt character 

($33) go to state 2 to ignore the. line. 

Set state to 2 (ignore non-DOS command) just in case. 

If output character is not a control-D, go to 

state 2. 

Otherwise, set state to 1 (collect possible DOS 

command) , set line index to zero, and fall through 

to state 1. 

9F12-9F22 State 1 output handler, --collect DOS command- 
Using line index, store character in input buffer at 
$200. 

Increment line index. 

If character is not a carriage return, exit DOS 
via 9F95 (echo character on screen if MON I) . 
Otherwise, go to command scanner at 9FCD. 

9F23-9F2E State 2 output handler. — non-DOS command ignore — 
If the character is not a carriage return, exit DOS 
via 9FA4 (echo character on screen) . 
Otherwise, set state back to and exit DOS via 
9FA4. 

9F2F-9F51 State 3 output handler. — INPUT statement handler — 
Set state to in case INPUT ends. 
If character is not a carriage return, echo it on 
screen as long as EXEC is not in effect with NOMON I 
but exit DOS in any case. (KSWL will set state=3) 
Otherwise, call A65E to see if BASIC is executing a 
program or is in immediate mode. If EXEC is running 
or if BASIC is in immediate mode, go to state 1 to 
collect the possible DOS command. 
Otherwise, exit DOS, echoing the character as 
appropriate. 

9F52-9F60 State 4 output handler. --WRITE data to a file — 

If the character is a carriage return, set state to 

5 (start of write data line) . 

Call A60E to write the byte to the disk file. 

„ Exit DOS with echo on screen if MON 0. 
o-o 
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-9F70 State 5 output handler. --Start of WRITE data line— 
If the character is a control-D, go to state to 
immediately exit write mode. 

If the character is a line feed, write it and exit, 
staying in state 5. 
Otherwise, set the state to 4 and go to state 4. 

-9F77 State 6 output handler. — Skip prompt character — 
Set state to 0. 
Exit DOS via 9F9D (echo if MON I) . 

9F82 Finish RUN command, interrupted by APPLESOFT RAM LOAD 
Reset the "RUN interrupted" flag. 
Call A851 to replace the DOS CSWL/KSWL intercepts. 
Go to A4DC to complete the RUN command. 

-9F94 DOS command scanner exit to BASIC routine. 

If first character of command line is control-D, 
go to echo exit (9F95) . 

Otherwise, set things up so BASIC won't see the DOS 
command by passing a zero length line (only a 
carriage return). Fall through to echo exit. 






<3 9F95-9FB0 Echo character on screen (conditionally) and exit DOS 

9F95 Echo only if MON C set, otherwise, go to 9FB3. 

9F99 Echo only if MON set, otherwise, go to 9FB3. 

>3| 9F9D Echo only if MON I set, otherwise, go to 9FB3. 

9FA4 Always echo character. 

— Call 9FBA to restore registers at entry to DOS. 

*4 Call 9FC5 to echo character on screen. 

Save contents of the registers after echoing. 

■jm Fall through to DOS exit routine. 

9FB3-9FC4 DOS exit routine and register restore. 
3| Call A851 to put back DOS KSWL/CSWL intercepts. 

" Restore S (stack) register from entry to DOS. 

9FBA DOS register restore subroutine. 
3 Restore registers from first entry to DOS and return 

to caller . 

iij] 9FC5-9FC7 A jump to the true CSWL routine. 

9FC8-9FCC Skip a line on the screen. 

Load a carriage return into the A register and 
call 9FC5 to print it. 

9FCD-A179 DOS command parse routine. 

Set the command index to -1 (none) . 
Reset the pending command flag (none pending) . 
9FD6 Add one to command index. 

If first charcater is a control-D, skip it. 

Flush to a non-blank (call A1A4) . 

Compare command to command name in command name table 

at A884 for the current command index. 

If it doesn't match and if there are more entries 

left to check, go back to 9FD6 . 

If it does match, go to A01B. 
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Otherwise, if command was not found in the table, 

check to see if the first character was a control-D 

If so, go to A6C4 to print "SYNTAX ERROR". 

Otherwise, call A75B to reset the state and warmstart 

flag and go to 9F95 to echo the command and exit. 

(the command must be for BASIC, not DOS) 
A01B Compute an index into the operand table for the 

command which was entered. 

Call A65E to see if a BASIC program is executing. 

If not, and the command is not a direct type command, 

(according to the operand table) go to A6D2 to print' 

"NOT DIRECT COMMAND" . 

Otherwise, if the command is RON, make the prompt 

character ($33) non-printing. 

Check the operand table to see if a first filename 

is a legal operand for this command. 

If not, go to AOAO. 

Otherwise, clear the filename buffer (call A095) . 

Flush to the next non-blank (call A1A4) and copy 

the filename operand to the first filename buffer. 

Skip forward to a comma if one was not found yet. 

If a second filename is legal for this command, use 

the code above to copy it into the second filename 

buffer . 

Check both filenames to see if they are blank. 

If one was required by the command but not given, 

give a syntax error or pass it through to BASIC. 

(As in the case of LOAD with no operands) 

If all is well, go to A0D1 to continue. 
A095 A subroutine to blank both filename buffers. 
AOAO Indicate no filename parsed. 

Check operand table to see if a positional operand 

is expected. 

If not, go to A0D1 to continue. 

Otherwise, call A1B9 to convert the numeric operand. 

If omitted, give syntax error. 

If number converted exceeds 16, give "RANGE ERROR" 

If number is supposed to be a slot number, give 

"RANGE ERROR" if it exceeds 7. 

If number is not a slot number, give "RANGE ERROR" if 

it is zero. (MAXFILES is a no-no) 
A0D1 Set defaults for the keyword operands (V=0 ,L=0 ,B=0) 
A0E8 Get the line offset index and flush to the next 
non-blank, skipping any commas found. 

If we are not yet to the end of the line, go to A10C. 
Check to see if any keywords were given which were 
not allowed for this command. 
If not, go to A17A to process the command. 
A10C Lookup the keyword found on the command line in the 
table of valid keywords (A941) . 
If not in table, give "SYNTAX ERROR" message. 
Get its bit position in the keywords-given flag. 
If the keyword does not have an operand value, qo to 
A164. 

Otherwise, indicate keyword found in flag. 
Convert the numeric value associated with keyword. 
Give "SYNTAX ERROR" message if invalid. 
Check to see if the number is within the acceptable 
range as given in the keyword valid range table at 
A955. 
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Save the value of the keyword in the keyword values 

table starting at AA66. 

Go parse the next keyword, go to A0E8 . 

A164 Indicate C, I, or keywords were parsed. 

Update the MON value in the keyword value table 

appropriately. 

Go parse the next keyword, go to A0E8. 

A17A-A17F Call A180 to process the command, then exit via echo 
at 9F83. 

A180-A192 Do command. 

Reset the video intercept state to zero. 

Clear the file manager parameter list. 

Using the command index, get the address of the 

command handling routine from the command handler 

routine table at 9D1E and go to it. 

Command handler will exit to caller of this routine. 

A193-A1A3 Get next character on command line and check to see 
if it is a carriage return or a comma. 

A1A4-A1AD Flush command line characters until a non-blank is 
found . 



A1AE-A1B£ 



Clear the file manager parameter list at B5BB to 
zeros . 
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A1B9-A1D5 Convert numeric operand from command line. Call 

either A1D6 (decimal convert) or A203 (hex convert) 
depending upon the presence or lack thereof of a 
dollar sign ($) . 



A1D6-A202 Decimal convert subroutine. 

A228 Hexadecimal convert subroutine. 

A22D PR#n command handler. 

Load the parsed numeric value and exit via FE95 in 
the monitor ROM. 
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A22E-A232 IN#n command handler. 

Load the parsed numeric value and exit via FE8B in 
the monitor ROM. 

A233-A23C MON command handler. 

Add new MON flags to old in AA5E and exit. 



NOMON command handler. 

If C was given, put out a carriage return since this 

line was echoed but its CR was not. 

Turn off the proper bits in AA5E and exit. 

A251-A262 MAXFILES command handler. 

Turn off any EXEC file which is active. 

Close all open files (call A316) . 

Set the new MAXFILES number at AA57. 

Go to A7D4 to rebuild the DOS file buffers and exit. 
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A263-A270 DELETE command handler. 

Load the delete file manager opcode (05) . 

Call the file manager open driver (A2AA) to perform 

the delete. 

Find the file buffer used to do the delete and free 

it (call A764) . 

Exit to caller. 






A271-A274 LOCK command handler. 

Load the lock file manager opcode 
A277. 



A2EA-A2FB CLOSE command handler . 

If no filename was given as part of command, 

go to A316 to close all files. 

Otherwise, find the open file buffer for filename 

(A764) . 

If no such file open, exit to caller. 

Otherwise, close file and free buffer (A2FC) . 

Go back through CLOSE command handler to make sure 

there are not more open buffers for the same file. 



(07) and go to 



A275-A27C UNLOCK command handler. 

Load the unlock file manager opcode (08) . 
A277 Call the file manager open driver (A2AA) to perform 
the desired function. 
Exit to the caller via close (A2EA) . 






A27D-A280 VERIFY command handler. 

Load the verify file manager opcode 
A277 to perform function. 



(0C) and go to 



A281-A297 RENAME command handler. 

Store address of second file name in file manager 

parameter list. 

Load the rename file manager opcode (09) . 

Call the file manager driver at A2C8. 

Exit via close (A2EA) . 

A298-A2A2 APPEND command handler. 

Call A2A3 to OPEN the file. 

Read the file byte by byte until a zero is found. 

If append flag is on, add one to record number 

and turn flag off. 

Exit via a call to POSITION. 

A2A3-A2A7 OPEN command handler . 
Set file type as TEXT. 
Go to A3D5 to open file. 

A2A8-A2E9 Command handler common file management code. 

Set opcode to OPEN. 
A2AA If no L value was given on the command, use 0001 and 

store record length value in file manager parmlist. 
A2C8 Close file if already open. 

Is there an available file buffer? 

If not, issue "NO FILE BUFFERS AVAILABLE" message. 

Point $40, $41 at the free file buffer. 

Copy filename to file buffer (allocates the buffer) 

(A743) . 

Copy buffer pointers to file manager parmlist (A74E) , 

Finish filling in the file manager parmlist (A71A) . 

Set operation code in parmlist. 

Exit through the file manager driver. 



>1 A2FC 



A316-. 



■A315 Close a file and free its file buffer. 

Find out if this buffer is EXEC's (A7AF) . 

If so, turn EXEC flag off. 

Release the buffer by storing a $00 on its filename 

field. 

Copy file buffer pointers to the file manager 

parmlist. 

Set file manager opcode to CLOSE. 

Exit through the file manager driver routine. 

A330 Close all open files. 

Point to first file buffer (A792) . 

Go to A320. 
A31B Point to next file buffer on chain (A79A) . 

If at end of chain, exit to caller. 
A320 Is this file buffer EXEC's? 

If so, skip it and go to A31B. 

Is it not in use (open)? 

If so, skip it and go to A31B. 

Otherwise, close it and free it (A2FC) . 

Go to A316 to start all over. 
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A331-A35C BSAVE command handler. 

Insure that the A and L keywords were present on the 

command . 

If not, issue "SYNTAX ERROR" message. 

Open and verify a B type file (A3D5) . 

Write the A keyword value as the first two bytes of 

the file. 

Write the L keyword value as the next two bytes of 

the file. 

Use the A value to exit by writing a range of bytes 

from memory to the file. 

A35D-A38D BLOAD command handler. 

Open the file, ignoring its type. 

Insure the type is B. 

If not, issue "FILE TYPE MISMATCH" message. 

Otherwise, open B type file and test file type (A3D5) 

Read the A value from the first two bytes of file. 

If A keyword was not given, use the value just read. 

Read L value as next two bytes in file. 

Go to A471 to read range of bytes to memory from file 

A38E-A396 BRUN command handler. 

Call BLOAD command handler to load file into memory. 
Replace DOS intercepts. 

Exit DOS by jumping to the A address value to begin 
execution of the binary program. 
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A397-A3D4 SAVE command handler. 

Get the active BASIC type (AAB6) . 
If INTEGER, go to A3BC. 

If APPLESOFT, test $D6 flag to see if program is 
protected. 

If so, issue "PROGRAM TOO LARGE" message. 
Otherwise, open and test for A type file (A3D5) . 
Compute program length (PGMEND-LOMEM) . 
Write this two byte length to file. 

Exit by writing program image from LOMEM as a range 
of bytes (A3FF) . 
A3BC Open and test for I type file (A3D5) . 

Compute program length (HIMEM-PGMSTART) . 

Write this two byte length to file. 

Exit by writing program image from PGMSTART as a 

range of bytes (A3FF) . 

A3D5-A3DF Open and test file type. 

Set file type wanted in file manager parmlist. 

Call A2A8 to open file. 

Go to A7C4 to check file type. 

A3E0-A3FE Write a 2 byte value to the open file. 

Store value to be written in file manager parmlist. 

Set write one byte opcodes. 

Call file manager driver. 

Call it again to write second byte and exit to caller 

A3FF-A40F Read/write a range of bytes. 

Set the address of the range in file manager parmlist 

Set subcode to read or write a range of bytes. 

Call the file manager driver. 

Close the file. 

Exit through the VERIFY command handler to insure 

data was written ok. 

A410-A412 Issue "FILE TYPE MISMATCH" message. 

A413-A479 LOAD command handler. 

Close all files (A316) . 

Open the file in question. 

Is it an A or I type file? 

If not, issue "FILE TYPE MISMATCH" message. 

Which BASIC is active? 

If INTEGER, go to A450. 

Select APPLESOFT BASIC (A4B1) . This call could result 

in DOS losing control if the RAM version must be 

run . 

Read first two bytes of file as length of program. 

Add length to LOMEM (program start) to compute 

program end. 

Is program end beyond HIMEM? 

If so, close file and issue "PROGRAM TOO LARGE". 

Set program end and start of variables pointers. 

Read program as range of bytes to program start. 

Replace DOS intercepts (A851) . 

Go to BASIC'S relocation routine to convert a RAM 

APPLESOFT program to ROM and vice versa as needed. 
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A450 Select INTEGER BASIC (A4B1) . 

Read length of program (first two bytes in file) . 

Compute program start (HIMEM-LENGTH) . 

If zero or less than LOMEM, issue "PROGRAM TOO LARGE" 

message and close file. 

Set program start pointers. 

Read program into memory as a range of bytes. 

Exit to caller. 

A47A-A4AA Read two bytes from file (Address or Length) . 

Set up parmlist to read two bytes to range length 

field (AA60) . 

Call file manager driver. 

Store value read as range length in file manager 

parmlist just in case it was a length. 

A4AB-A4B0 Close file and issue "PROGRAM TOO LARGE" message. 

•A4D0 Select desired BASIC. 

If desired BASIC is already active, exit to caller. 

Save current command index in case we must RUN 

APPLESOFT. 

If INTEGER, go to A59E to select it. 

Otherwise, copy primary file name to secondary 

buffer to save it in case RAM APPLESOFT is needed. 

Go to A57A to set APPLESOFT. 

A4D1-A4E4 RUN command handler. 

If APPLESOFT is active, set RUN intercepted flag so 

that RUN can complete after APPLESOFT is loaded. 

Call LOAD command handler to load the program. 

Skip a line on the screen. 

Put DOS intercepts back. 

Go to the RUN entry point in the current BASIC. 



-A4EF INTEGER BASIC RUN entry point intercept. 
Delete all variables (CLR equivalent). 
Go to the CHAIN entry point in INTEGER BASIC. 

A4F0-A4FB CHAIN command handler. 

Call the LOAD command handler to load the program. 

Skip a line. 

Replace DOS intercepts. 

Go to current BASIC'S CHAIN entry point. 



A4FC- 



^A4E5 

■ ra A510 
31 



A505 APPLESOFT ROM RUN entry point intercept. 
Call APPLESOFT to clear variables. 
Reset ONERR. 
Go to RUN entry point. 



A506-A50D APPLESOFT RAM RUN entry point intercept. 
Call APPLESOFT to clear variables. 
Reset ONERR. 
Go to RUN entry point. 



■A51A WRITE command handler. 

Call READ/WRITE common code (A526) . 

Set CSWL state to 5 (WRITE mode line start) 

Exit DOS (9F83) . 
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A51B-A525 READ command handler. 

Call READ/WRITE common code (A526) . 

Set READ mode flag in status flags (AA51) . 

Exit DOS (9F83) . 

A526-A54E READ/WRITE common code. 

Locate the open file buffer for this file (A764) 

If not open, open it. 

Copy file buffer addresses to file manager parmlist. 

If R or B were given on command, copy to parmlist 

and issue a POSITION call to file manager. 

Exit to caller. 

A54F-A56D INIT command handler. 

If V was given, use it. Otherwise, use 254. 

Store first page number of DOS in file manager 

parmlist. 

Call file manager driver to INIT diskette. 

Exit through SAVE to store greeting program on disk. 

A56E-A579 CATALOG command handler. 

Call file manager with CATALOG opcode. 

Set new V value as default for future commands. 

Exit to caller. 

A57A-A59D FP command handler. 

Set ROM card, if any, for APPLESOFT (A5B2) . 

If successful, coldstart DOS (9D84) . 

Otherwise, set status flag to indicate INTEGER BASIC 

is active. 

Set primary filename buffer to "APPLESOFT". 

Set flags to indicate RAM APPLESOFT and coldstart. 

Go to RUN command handler. 

A59E-A5B1 INT command handler. 

Set ROM card, if any, for INTEGER BASIC (A5B2) . 
If not successful, issue "LANGUAGE NOT AVAILABLE". 
Otherwise, clear RUN intercepted flag. 
Coldstart DOS (9D84) . 

A5B2-A5C5 Set ROM to desired BASIC. 

(This routine is passed a $4C for APPLESOFT or a $20 

for INTEGER, since these bytes appear at $E000 in 

these BASICS. It will work regardless of which 

BASIC is onboard) 

If desired BASIC is already available, exit. 

Try selecting ROM card. 

If desired BASIC is now available, exit. 

Try selecting onboard ROM. 

If desired BASIC is now available, exit. 

Otherwise, exit with error return code. 

A5C6-A5DC EXEC command handler. 
Open the file (A2A3) . 

Copy file buffer address to EXEC's buffer pointer at 
AAB4,AAB5. 

Set EXEC active flag (AAB3) . 
Jump into POSITION command handler to skip R lines. 
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A5DD-A60D POSITION command handler. 

Locate the open file buffer (A764) . 
If not found, open one as a TEXT file. 
Copy buffer pointers to file manager parmlist. 
If R was not given on command, exit. 
A5F2 Otherwise, test R value for zero and exit if so. 
Decrement R value by one. 

Read file byte by byte until a carriage return (end 
of line - $8D) is reached. 

If at end of file, issue "END OF FILE" message. 
Otherwise, go to A5F2 to skip next record. 

A60E-A625 Write one data byte to file. 

Insure that BASIC is running a program (A65E) . 

If not, close file and warmstart DOS. 

Set up file manager parmlist to write the data byte 

to the open file. 

Call file manager and exit. 

A626-A65B Read one data byte from file. 

Insure that BASIC is running a program (A65E) . 

If not, close file and warmstart DOS. 

Set CSWL intercept state to 6 (skip prompt character) 
A630 Read next file byte (A68C) . 

If not at end of file, go to A644. 

Otherwise, close file. 

If state is not 3 (EXEC) issue "END OF DATA" message. 

Exit to caller. 
A644 If data byte is lower case character, turn its most 

significant bit off to fool GETIN routine in monitor. 

Store data byte in A register saved at entry to DOS. 

Using line index, turn high bit back on in previous 

data byte stored at $200 (input line buffer) to make 

it lower case if necessary. 

Exit DOS (9FB3) . 

A65E-A678 Test to see if BASIC is running a program or is in 
immediate command mode. 

If active BASIC is INTEGER, go to A672. 
If line number is greater than 65280 and prompt is 
"]" then APPLESOFT is in immediate mode. 
Otherwise, it is executing a program. 
Exit to caller with appropriate return code. 
A672 Check $D9 to determine whether BASIC is executing a 
program and exit with proper return code. 

A679-A681 Close current file and warmstart DOS. 

A682-A68B EXEC read one byte from file. 
Select EXEC file buffer. 

Copy file buffer addresses to file manager parmlist. 
Set state to 3 (input echo) . 
Go to A62D to read a file byte. 

A68C-A69C Read next text file byte. 

Set up file manager parmlist to read one byte. 

Call file manager driver. 

Return to caller with the data byte. 
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A69D-A6A7 Set $40, $41 to point to EXEC file buffer. 

A6A8-A6C3 File manager driver routine. 

Call the file manager itself (AB06) . 

If no errors, exit to caller. 

Otherwise, point $40, $41 at file buffer. 

If found., release it by storing a zero on the file 

name field. 

If error was not "END OF DATA", print error message.' 

Otherwise, pretend a $00 was read and return to 

caller . 

A6C4-A6D4 Miscellaneous error messages. 
A6C4 "COMMAND SYNTAX ERROR" 
A6C8 "NO FILE BUFFERS AVAILABLE" 
A6CC "PROGRAM TOO LARGE" 
A6D0 "FILE TYPE MISMATCH" 

A6D5-A701 Error handler. 

Set warmstart flag and clear status (BFE6) . 
If APPLESOFT ONERR is active, go to A6EF. 
Otherwise, print RETURN BELL RETURN. 
Print text of error message (A702) . 
Print another RETURN. 
A6EF Replace DOS intercepts. 

If a BASIC program is in execution, pass error code 
to BASIC'S error handler. 
Otherwise, warmstart BASIC. 

A702-A719 Print text of error message. 

Using the error number as an index, print the message 
text from the message table (A971) byte by byte. 
Last character has most significant bit on. 

A71A-A742 Complete file manager parameter list. 
Copy Volume value to parmlist. 
Copy Drive value to parmlist. 
Copy Slot value to parmlist. 

Copy address of primary filename buffer to parmlist. 
Save file buffer address in $40, $41. 
Return to caller. 

A743-A74D Copy primary filename to file buffer filename field. 

A74E-A7 5A Copy current buffer pointers to file manager parmlist 
Copy file manager workarea buffer pointer. 
Copy T/S List: sector buffer pointer. 
Copy data sector buffer address. 
Copy next file buffer link address. 
Return to caller. 

A75B-A763 Reset state to and set warmstart flag. 

A764-A791 Locate an open or free file buffer. 

Assume there are no free file buffers by zeroing $45. 

Point $40, $41 at first buffer on chain. 

Go to A773. 
A76E Point $40, $41 at next buffer on chain. 
g_-|g If at end of chain, exit with file not open code. 




A773 Get first byte of filename field. 

If zero (file buffer free) , save file buffer address 

at $44, $45 as an available buffer and go to A76E. 

Otherwise, see if name in primary filename buffer 

matches the name in this file buffer. 

If not, go to A76E to get next buffer. 

If so, return to caller with open file found code. 

A792-A799 Point $40, $41 at first file buffer on chain. 

A79A-A7A9 Point $40, $41 at next file buffer on chain. 

A7AA-A7AE Get first byte of file name in file buffer. 

A7AF-A7C3 See if current buffer belongs to EXEC. 
Is EXEC active? 
If not, exit. 

If so, does current buffer address match EXEC's? 
Return to caller with appropriate code. 

A7C4-A7D3 Check file type. 

Does file type of open file match desired file type? 

If so, exit. 

Otherwise, turn lock bit off and test again. 

If ok, exit. 

Otherwise, close file and issue "FILE TYPE MISMATCH". 






A7D4-A850 Initialize (build) DOS fil 
Set $40, $41 to point to fi 
Set counter to MAXFILES va 

A7E5 Store zero on filename fie 
Set up link pointers in bu 
manager workarea (45 bytes 
Set up link pointer to T/S 
bytes from file manager wo 
Set up link pointer to dat 
before that. 
Decrement counter. 
If zero, go to A82D to set 
Otherwise, set link to nex 
prior to data sector buffe 
Go to A7E5 to set up next 

A82D Set link of last buffer to 
If INTEGER BASIC is active 
Otherwise, set APPLESOFT'S 
pointers in zeropage to po 
buffer . 
Exit to caller. 

A846 Set INTEGER BASIC'S HIMEM 
to point just below the la 
Exit to caller. 



e buffer chain. 

rst buffer. 

lue . 

Id to mark as free. 

ffer to point to file 

prior to filename field) . 

List sector buffer (-256 
rkarea buffer) . 
a sector buffer 256 bytes 



HIMEM. 
t file buffer as 38 bytes 
r . 
buffer . 

$0000. 
, go to A8 46. 

HIMEM and STRING START 
int just below the last 



and PROGRAM START pointers 
st buffer. 



A851-A883 Replace DOS keyboard/video intercept vectors. 
Is DOS keyboard (KSWL) vector still set? 
If so, go to A8 6A. 

Otherwise, save current KSWL vector ($38, $39) at 
AA55,AA56 and replace with DOS intercept routine's 
address . 



1 
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A86A Is DOS video (CSWL) vector still set? 
If so, exit to caller. 

Otherwise, save current CSWL vector ($36, $37) at 
AA53,AA54 and replace with DOS intercept routine's 
address . 
Exit to caller. 

A884-A908 DOS command name text table. 

This table consists of the ASCII name for each DOS 
command in order of command index values, with the 
last character, of each indicated by the MSB being 
on. Commands in order are: 

INIT , LOAD, SAVE , RUN , CHAIN .DELETE ,LOCK , UNLOCK , CLOSE , 
READ , EXEC , WRITE , POSITION , OPEN , APPEND , RENAME , 
CATALOG ,MON ,NOMON ,PR# , IN# ,MAXFILES ,FP , INT ,BSAVE , 
BLOAD , BRUN , VERIFY . 

Example: INIT is $49 $4E $49 $D4 (INIT) 

A909-A940 Command valid keywords table. 

This table is used to determine which keywords are 
required or may be given for any DOS command. 
Each command has a two byte entry with 16 flags, 
indicating which keywords may be given. The flag 
bit settings are as follows: 
BIT MEANING 

Filename legal but optional 

1 Command has no positional operand 

2 Filename #1 expected 

3 Filename #2 expected 

4 Slot number positional operand expected 

5 MAXFILES value expected as positional operand 

6 Command may only be issued from within a program 

7 Command may create a new file if file not found 

8 C, I, keywords legal 

9 V keyword legal 

10 D keyword legal 

11 S keyword legal 

12 L keyword legal 

13 R keyword legal 

14 B keyword legal 

15 A keyword legal 

Thus, for a typical command, OPEN, where the value 
is $2378, bits 2, 6, 7, 9, 10, 11, and 12 are set so 
the command has one filename operand, may only be 
issued from within a program, may create a new file, 
and the V, D, S, and L keywords are legal. 



The command entries are: 




INIT 


2170 


LOAD 


A070 


SAVE 


A170 


RUN 


A070 


CHAIN 


2070 


DELETE 


2070 


LOCK 


2070 


UNLOCK 


2070 


CLOSE 


6000 


READ 


2206 


EXEC 


2074 


WRITE 


2206 


POSITION 


2204 


OPEN 


2378 


APPEND 


2270 


RENAME 


3070 


CATALOG 


4070 


MON 


4080 


NOMON 


4080 


PRt 


0800 


IN# 


0800 


MAXFILES 


0400 


FP 


4070 


INT 


4000 


BSAVE 


2179 


BLOAD 


2071 


BRUN 


2071 


VERIFY 


2070 
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A941-A94A Keyword name table. 

This table contains all the ASCII names of the DOS 
keywords in standard order . Each keyword name 
occupies one byte: 

V,D,S,L,R,B,A,C,I,0 

A94B-A954 Keyword flag bit positions table. 

This table gives the bit positions for each keyword 
into the second byte of the command valid keyword 
table above and in the flag (AA65) which indicates 
which keywords were present on the command line. 
The bit positions are: 



V - 


40 


D - 


20 


S - 


10 


L - 


08 


R - 


04 


B - 


02 


A - 


01 


C - 


CO 


I - 


A0 


- 


90 



not used in valid keyword table 



8-18 






8-19 



KEYWORD 


MIN 


V 





D 


1 


S 


1 


L 


1 


R 





B 





A 






A955-A970 Keyword value valid range table. 

This table indicates the range any keyword value 
may legally have. Each keyword has a four byte entry 
two bytes of minimum value, and two bytes of maximum' 
value. Values are: 

MAX 

254 

2 

7 

32767 

32767 

32767 

65535 

C, I, and do not appear in this table since they 
do not have numeric values. 

A971-AA3E Error message text table. 

This table contains the text for each error code in 

order of error code number: 
NUMBER TEXT 

RETURN BELL RETURN 

1 "LANGUAGE NOT AVAILABLE" 

2 "RANGE ERROR" (Bad file manager opcode) 

3 "RANGE ERROR" (Bad file manager subcode) 

4 "WRITE PROTECTED" 

5 "END OF DATA" 

6 "FILE NOT FOUND" 

7 "VOLUME MISMATCH" 

8 "I/O ERROR" 

9 "DISK FULL" 

10 "FILE LOCKED" 

11 "SYNTAX ERROR" 

12 "NO BUFFERS AVAILABLE" 

13 "FILE TYPE MISMATCH" 

14 "PROGRAM TOO LARGE" 

15 "NOT DIRECT COMMAND" 

AA3F-AA4F Error message text offset index table. 

This table contains the offset in bytes to the text 
of any given error message in the table above. 
Entries are one byte each for each error code number 
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AA66-AA74 Keyword values parsed from command and defaulted. 
AA66 Volume (2 bytes) 
AA68 Drive (2 bytes) 
AA6A Slot (2 bytes) 
AA6C Length (2 bytes) 
AA6E Record (2 bytes) 
AA70 Byte (2 bytes) 
AA72 Address (2 bytes) 
AA74 MON value (one byte) 

AA75-AA92 Primary file name buffer 

AA9 3-AAB0 Secondary "(RENAME) file name buffer 

AAB1-AAC0 DOS main routines constants and variables. 
AAB1 MAXFILES default ($03) . 
AAB2 Control-D ($84) . 

AAB3 EXEC file active flag ($00=not active) . 
AAB4 EXEC file buffer address (2 bytes) . 
AAB6 Active BASIC flag: $00=INTEGER, $40=APPLESOFT ROM, 

$80=APPLESOFT RAM 
AAB7 RUN intercepted flag. 
AAB8 "APPLESOFT" characters in ASCII (9 bytes) 

AAC1-AAC8 File manager constants. 

AAC1 Address of RWTS paramter list (B7E8) . 

AAC3 Address of VTOC sector buffer (B3BB) . 

AAC5 Address of directory sector buffer (B4BB) . 

AAC7 Address of last byte of DOS plus one. (C000) 

AAC9-AAE4 File manager function routine entry point table. 
This table contains a two byte function handler 
routine address for each of the 14 file manager 
opcodes in opcode order . 

AAE5-AAF0 File manager read subcode handler entry point table. 
This table contains a two byte function handler 
routine address for each of the 6 read subcodes. 

AAF1-AAFC File manager write subcode handler entry point table. 
This table contains a two byte function handler 
routine address for each of the 6 write subcodes. 



AA4F-AA6 5 
AA4F 
AA51 

AA52 
AA53 
AA5 5 
AA57 
AA59 

AA5D 
AA5E 
AA5F 
AA60 
AA62 
AA63 
AA64 
AA65 
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DOS main routines variables. 

Current file buffer address (2 bytes). 

Status flags: $01=READ state, $00=Warmstart , 

$80=Coldstart, $40=APPLESOFT RAM 
DOS CSWL intercept state number. 
Address of true CSWL handler (2 bytes) . 
Address of true KSWL handler (2 bytes) . 
MAXFILES value. 

Save area for S, X, Y, and A registers when DOS is 
entered (4 bytes) . 

Command line index value (offset into line) . 
MON flags: (C=$40, I=$20, O=$10) 
Index of last command times 2. 
Range length for LOAD and BLOAD (2 bytes) . 
Index of pending command, if any. 
Scratch variable (counter, message index, etc.) 
Index of current keyword. 
Keywords present on command line flags. 



3 AAFD-AB05 File manager external entry point (from $3D6) . 
Is X register zero? 
^_ I If so, allow new files by simulating an INIT command 

t- ' *§ index. 

Otherwise, require old file by simulating a LOAD 
■>£ -^ command index . 

Fall through to main file manager entry point. 



ft 

ft! -* 



jm AB06-AB1E File manager main entry. 
Save S register at B39B. 



Restore file manager workarea from file buffer (AE6A) 
Make sure opcode does not exceed 13. 
If it does, return with code=2 (invalid opcode). 
Use opcode as index into file manager function 
routine entry point table and go to proper handler 
via RTS. 
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AB1F-AB21 Return with return code=2 (bad opcode) . 

AB22-AB27 OPEN function handler. 

Call common open code (AB28) . 
Exit file manager. 

AB28-ABDB Common open routine. 

Initialize file manager workarea by resetting 
variables to their defaults (ABDC) . 
Set sector length to 256. 

Insure record length is non-zero. If zero, use 1. 
Store record length in file manager workarea. 
Locate or allocate a directory entry for the file 
(B1C9) . 

If file already exists, go to ABA6 . 
Otherwise, save directory index for free entry. 
Using last command index and valid keywords table, 
determine whether current command may create a new 
file. 

If so, go to AB64. 

Otherwise, if running "APPLESOFT", set return code 
to "LANGUAGE NOT AVAILABLE" and exit. 
If not running "APPLESOFT" set return code to "FILE 
NOT FOUND" and exit. 
AB64 Set sector count in directory entry to 1 (there will 
only be a T/S List sector initially) . 
Allocate a sector for a T/S List (B244) . 
Store sector number of this sector in directory 
entry and in first and current T/S List sector number 
in file manager workarea. 
Store track number in both places also. 
Move file type desired to directory entry. 
Write directory sector back to catalog (B037) . 
Select T/S List buffer (AFOC) . 
Zero it (B7D6) . 
And write it back (AF3A) . 
Set return code to 6 ("FILE NOT FOUND"). 
ABA6 Place track/sector of T/S List in directory entry in 
first T/S List variable in file manager workarea. 
Copy file type from directory to parmlist to pass it 
back to caller and to file manager workarea. 
Copy number of sectors in file to workarea. 
Save directory offset to entry in workarea. 
Set end of data pointer to "infinity". 
Set number of data bytes represented by one T/S List 
sector to 122*256 (30. 5K) in workarea. 
Go read first T/S List sector (AF5E) . 

ABDC-AC05 Initialize file manager workarea. 
Zero entire 45 bytes of workarea. 
Save complemented volume number in workarea. 
Save drive number in workarea. 
Save slot*16 in workarea. 
Set track number to $11 (catalog track) . 
Return to caller. 
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-AC39 CLOSE function handler . 

Checkpoint data buffer to disk if needed (AF1D) . 

Checkpoint T/S List buffer if needed (AF34) . 

Release any sectors which were preallocated but not 

used (B2C3) . 

If VTOC does not need to be re-read, exit. 

Otherwise, re-read VTOC sector (AFF7) . 

Flush through directory sectors in the catalog until 

we reach the one which contains the entry for this 

file. 

Get the index to the entry. 

Update the sector count in the entry to reflect the 

new file's length. 

Checkpoint the directory sector back to the disk. 

Exit file manager . 

-AC57 RENAME function handler. 

Call common code to locate/open the file. 

If file is locked, exit with "FILE LOCKED" return 

code . 

Set $42, $43 to point to new name. 

Copy new name to directory entry. 

Write back directory sector to disk. 

Exit file manager. 

-AC69 READ function handler. 

Insure subcode does not exceed 5. If so, exit with 

return code=3. 

Use subcode as index into READ subcode handler entry 

point table. 

Go to proper handler of subcode. 

-AC6C Return code = 3, subcode bad 

-AC6F "FILE LOCKED" error return 

-AC86 WRITE function handler. 

If file is locked, exit with "FILE LOCKED" error. 

Insure subcode does not exceed 5. If so, exit with 

return code=3. 

Use subcode as index into WRITE subcode handler entry 

point table. 

Go to proper handler of subcode. 

-AC89 POSITION AND READ ONE BYTE subcode handler 
Call position routine. 
Fall through to next subcode handler. 

AC8A-AC92 READ ONE BYTE subcode handler. 
Read next file byte (ACA8) . 
Store in parmlist for pass back to caller. 
(Jj gj Exit the file manager. 

AC93-AC95 POSITION AND READ A RANGE OF BYTES subcode handler. 
^-». ^J Call position routine. 

Fall through to next subcode handler . 
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AC96-ACA7 READ A RANGE OF BYTES subcode handler^ 
Decrement and check length (B1B5) . 
Read a byte (ACA8) . 

Point $42, $43 at range address and add one to address 
Store byte read at address. 

Loop back to AC96. (length check will exit file 
manager when length is zero.) 

ACA8-ACBA Read a data byte . 

Read next data sector if necessary (B0B6) . 

If at end of file, exit with "END OF DATA" error. 

Otherwise, load data byte from data sector buffer. 

Increment record number/byte offset into file (B15B) . 

Increment file position offset (B194) . 

Return with data byte read. 

ACBB-ACBD POSITION AND WRITE ONE BYTE subcode handler. 
Call position routine. 
Fall through to next subcode handler. 

ACBE-ACC6 WRITE ONE BYTE subcode handler. 
Find data byte to be written. 
Write it to file (ACDA) . 
Exit file manager. 

ACC7-ACC9 POSITION AND WRITE A RANGE OF BYTES subcode handler. 
Call position routine. 
Fall through to next subcode handler. 

AACA-ACD9 WRITE A RANGE OF BYTES subcode handler. 
Copy and advance range address pointer. 
Get next byte to write. 
Write it to file (ACDA) . 
Test and decrement length (B1B5) . 
Loop back to AACA. 

ACDA-ACEE Write a data byte. 

Read the proper data sector (if necessary) (B0B6) . 
Store data byte to be written in sector buffer. 
Flag data sector buffer as requiring rewrite. 
Increment record number/byte offset into file (B15B) . 
Exit via file position offset increment routine 
(B194) . 

ACEF-ACF5 LOCK function handler. 

Set mask byte to $80 (lock) . 
Go to common code (ACFB) . 

ACF6-ACFA UNLOCK function handler. 

Set mask byte to $00 (unlock) . 
Fall through to common code. 

ACFB-AD11 LOCK/UNLOCK common code. 
Locate/open file (AB28) . 
Get index into directory to entry. 

Update file type byte to lock ($8X) or unlock ($0X) . 
Write directory sector back to disk. 
Exit file manager. 






AD12-AD17 POSITION function handler. 
Call position routine. 
Exit file manager. 

AD18-AD2A VERIFY function handler. 
Locate/open file (AB28) . 
AD1B Read next data sector. 

If at end of file, exit file manager. 
Otherwise, increment sector position. 
And loop back to AD1B. 

AD2B-AD88 DELETE function handler. 
Locate/open file (AB28) . 

Using directory index, determine if file is locked. 
If so, exit with "FILE LOCKED" error code. 
Copy T/S List sector's track number from directory to 
workarea and to last character of file name in the 
directory entry itself. 

Store a $FF over T/S List sector's track number in 
directory entry to mark file deleted. 
Copy T/S List sector's sector number to workarea. 
Write directory sector back to disk. 
AD54 Read next T/S List sector (AF5E) . 

If no more exist, write VTOC and exit file manager. 
Otherwise, select T/S List buffer (AFOC) . 
Index to first T/S pair. 
AD5E If track number is zero or minus, skip it. 

Otherwise, free the data sector by updating the VTOC 

bit map (AD89) . 

Index to next T/S pair. 

If more, go to ADBE. 

Get T/S of next T/S List sector from this one. 

Free this T/S List sector (AD89) . 

Go process next one, if any (go to AD54) . 

Otherwise, write VTOC and exit file manager. 

AD89-AD97 Free a sector. 

Call B2DD to deallocate sector in VTOC bit map. 
Zero the sector allocation area of the workarea. 
Return to caller. 

AD98-AE2E CATALOG function handler. 

Initialize file manager workarea (ABDC) . 

Set V value to zero (complimented=$FF) . 

Read the VTOC sector (AFF7) . 

Set up a counter for 22 lines before waiting for 

the keyboard. 

Skip 2 lines on the screen. 

Print "DISK VOLUME ". 

Convert Volume number and print it (AE42) . 

Skip 2 more lines. 
ADCA Read next directory sector. 

If no more exist, exit file manager. 

Set index to first entry. 
ADD1 Get track number. 

If zero, exit file manager. 

If minus, skip entry (deleted file). 

Print "*'" if file is locked (check file type byte). 

Use file type as index into file type name table at 

B3A7 and print single character found there. 
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Print a blank. 

Convert and print the number of sectors in the file. 

Print a blank. 

Index to filename. 

Print file name. 

Skip to next line. 

Advance index to next directory entry. 

If there are more, go to ADD1. 

If not, go to ADCA to read next directory sector. 

Exit when finished. 

AE2F-AE41 Skip a line on CATALOG printout. 
Output a carriage return. 
Decrement line counter. 
If still nonzero, exit. 
Otherwise, wait for keyboard keypush. 
Then reset counter to 21 lines. 
And return to caller. 

AE42-AE69 Convert the number stored at $44 to a three character 
printable number and print it. 

AE6A-AE7D Restore file manager workarea from file buffer. 
Select file manager workarea buffer. 
Set return code in parmlist to zero initially. 
Copy 45 byte saved image of file manager workarea in 
file buffer to real file manager workarea. 
Exit to caller. 

AE7E-AE8D Save file manager workarea in file buffer. 
Select file manager workarea buffer. 
Copy 45 byte workarea to file buffer. 
Exit to caller. 

AE8E-AF07 INIT function handler. 

Initialize the file manager workarea (ABDC) . 

Call RWTS to format the diskette (B058) . 

Copy V value to VTOC buffer. 

Start track to allocate next value at $11. 

And direction of allocation as $01 (forward) . 

Zero VTOC bit map (all sectors in use) . 

Skipping the first three tracks and track $11, copy 

the 4 byte bit mask (B3A0) to each track entry in 

the VTOC bit map to free the sectors. This leaves the 

first three tracks and the catalog track marked in 

use. 

Zero the directory sector buffer. 

Point to directory sector buffer . 

Set track $11 in RWTS parmlist. 

Set up link from this directory sector to next (track 

$11, sector-1) . 

Call RWTS to write directory sector. 

Write each sector on track in this way except for 

sector zero. 

On last sector (sector 1) zero link pointer. 

Point RWTS parms at DOS load point (B7C2) . 

Write DOS image onto tracks 0-2 (B74A) . 

Exit file manager. 
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AF08-AF1C Select a buffer by setting $42, $43 to point to it. 
AF08 Select file manager workarea buffer in file buffer. 
AFOC Select T/S List sector buffer in file buffer. 
AF10 Select data sector buffer in file buffer. 
Exit to caller when $42, $43 are set. 

AF1D-AF33 Checkpoint write data sector buffer to disk. 

Test flag to see if buffer was changed since last 

read/write. 

If not, exit to caller. 

Otherwise, set up RWTS pointer (AFE4) . 

Call RWTS to write sector. 

Reset flag to indicate data sector no longer in need 

of a checkpoint. 

Exit to caller. 

AF34-AF4A Checkpoint write T/S List sector buffer to disk. 
Test flag to see if buffer was changed since last 
read/write. 

If not, exit to caller. 
Otherwise, set up RWTS pointer (AF4B) . 
Call RWTS to write sector. 

Reset flag to indicate T/S List sector no longer in 
need of checkpoint. 
Exit to caller. 

AF4B-AF5D Prepare for RWTS call with a T/S List sector. 

Copy address of T/S List buffer to RWTS parmlist. 
Get track/sector of sector. 
Exit to caller. 

AF5E-AFDB Read a T/S List sector to file buffer. 

(CARRY flag is set at entry to indicate whether the 
first T/S List for the file is wanted (C=0) or the 
next (C=l) . 

Memorize carry flag entry code. 

Checkpoint current T/S List sector if necessary. 
Set up for RWTS (AF4B) . 
Select T/S List buffer (AFOC). 
Is first or next wanted? 
If first, go to AFB5 to continue. 

Otherwise, get link to next T/S List from this one. 
If link is non-zero, use it to find next one and go 
to AFB5. 

Otherwise, we are out of T/S Lists for this file. 
If we are reading file, exit with error code. 
Otherwise, allocate a new sector (B244) . 
Point old T/S List sector to new one's track/sector. 
Write old T/S List sector back to disk. 
Zero the buffer to form new T/S List sector. 
Compute and store the relative sector number of the 
first sector listed in this sector at +5, +6 into the 
buffer . 

Set RWTS opcode to write new T/S List sector to disk. 
AFB5 Set RWTS opcode to read old T/S List (unless we just 
allocated it above) . 

Set track and sector and call RWTS to read old list 
or write new list. 

Compute relative sector number of last sector (plus 
one) in this list and store in workarea. 
Exit to caller with normal return code. 
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AFDC-AFE3 Read a data sector. 

Set up for RWTS (AFE4) . 

Set RWTS READ opcode and go to RWTS driver to do it. 

AFE4-AFF6 Prepare for RWTS with data sector. 

Copy address of data sector buffer to RWTS parmlist. 
Get its track/sector. 
And exit to caller. 

AFF7-B010 Read/write the VTOC buffer. 
AFF7 Read VTOC entry, go to AFFD. 
AFFB Write VTOC entry, fall through. 
AFFD Common code . 

Copy VTOC sector buffer address to RWTS parmlist. 

Get its track number and use sector $00. 

Exit through RWTS driver. 

B011-B036 Read a directory sector. 

(If CARRY flag is zero on entry, read first directory 
sector. If CARRY is one, read next) 
Memorize entry code. 
Set buffer pointers (B045) . 
First or next? 

If first, get track/sector of directory sector from 
VTOC at offset +l,+2. 

Otherwise, get track/sector from directory sector at 
offset +l,+2. If track is zero, exit with error code 
(end of directory) . 
Call RWTS to read sector. 
Exit with normal return code. 

B037-B044 Write directory sector. 
Set buffer pointers. 
Find its track/sector in workarea. 
Exit through RWTS to write it. 

B045-B051 Prepare for RWTS for directory buffer. 

Copy directory buffer address to RWTS parmlist. 
Exit to caller. 

B052-B0B5 Read/Write Track/Sector (RWTS) driver. 
Set track/sector in RWTS parmlist. 
B058 Set command code (read , write , etc . ) 
If writing, set flag (B5D5) . 
Set volume number expected in parmlist. 
Set slot*16 in parmlist. 
Set drive in parmlist. 
Set sector size in parmlist. 
Set IOB type in parmlist ($01) . 
Call RWTS, passing parmlist pointer. 
Copy true volume found to file manager parmlist. 
Reset volume expected field in RWTS parmlist. 
If an error did not occur, exit to caller. 
Otherwise, get return code. 

Translate vol mismatch to RC=7, write protected to 
RC=4 and all other errors to RC=8 (I/O error) . 
Exit file manager now. 



8-28 



m 

m 

6 






£ 



=1 

=1 
3 



B0B6-B133 Read next data sector (if necessary). 

Is the current file position in the current data 

sector now in memory? 

If so, go to B12C. 

Otherwise, checkpoint data sector buffer. 

Is the current file position prior to or after this 

T/S List's domain? 

If not, go to B0F3. 

Otherwise, read each T/S List for the file, starting 

with the first, until the proper one is found. 

If it is never found, exit with error (ran off end of 

file reading) . 
B0F3 Data is in this T/S List sector. 

Compute the displacement to the proper entry in this 

T/S List sector. 

Select the T/S List buffer. 

Get the track of the data sector wanted. 

If non-zero, go to B114. 

Otherwise, if not writing, exit with error (no data 

to read there) . 

If writing, allocate a new sector and store its 

track/sector location in the list at this point 
(B134) . 

Go to B120. 
B114 Read old data sector, using the track/sector found 

in the T/S List entry. 
B120 Save number of sector last read in workarea. 
B12C Select data buffer. 

Get byte offset and exit normally to caller. 

B134-B15A Add a new data sector to file. 
Allocate a sector (B244) . 

Put track/sector numbers in T/S List entry. 
Select data buffer and zero it. 

Set flags to indicate that the T/S List sector and 
the data sector buffer require checkpoints. 
Exit to caller. 

B15B-B193 Increment record number and byte offset into file. 
Copy current record number and byte offset to file 
manager parameter list to pass back to caller. 
Increment byte offset in workarea. 

If byte offset equals record length, set byte offset 
back to zero and increment record number . 
Return to caller.. 

B194-B1A1 Increment file position offset. 

Increment byte offset into current sector by one. 

If at end of sector,, increment sector number by one. 

Return to caller. 



K gM B1A2-B1B4 Copy and advance range address. 

Copy range address from file manager parmlist to $42. 

Increment range address in parmlist for next time 
C 4 through. 

Return to caller. 
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B1B5-B1C8 Decrement range length. 

Decrement range length in file manager parmlist by 

one . 

If zero, exit file manager. 

Otherwise, exit to caller. 

B1C9-B21B Locate or allocate a directory entry in the catalog. 

Read the VTOC sector (AFF7) . 

Set $42, $43 to point to file name we are looking for. 

Set pass number to one (locate file) . 
B1D8 Initialize directory sector offset (first sector) 
B1E1 Increment sector offset. 

Read directory sector. 

If at end of directory, go to B23A. 

Set entry index to first file entry. 
B1EB Get track. 

If deleted, skip entry, go to B217. 

If empty, end of directory, go to B212. 

Advance index to filename in directory. 

Compare against filename wanted. 

If they match, return entry index and exit. 
B20B If not, advance index to next entry in sector and 

loop back to B1EB. 

If at end of sector, go to B1E1 to get next sector. 
B212 If pass number is one, go to B1D8 to start second 

pass . 
B217 If pass number is one, go to B20B to skip entry. 

If second pass, fall through to allocate entry. 

B21C-B22F Copy file name to directory entry. 

Advance index to file name field in directory entry. 
Copy 30 byte filename to directory entry. 
Reload directory index and return to caller. 

B230-B239 Advance index to next directory entry in sector. 
Add 35 (length of entry) to index. 
Test for end of sector and return to caller. 

B23A-B243 Switch to second pass in directory scan. 

If on pass one, switch to pass 2 and go to B1D8 . 
If on pass two, exit file manager with "DISK FULL" 
error . 

B244-B2C2 Allocate a disk sector. 

Is there a track currently allocated to this file? 

If not, go to B26A to find a track with free sectors. 
B249 Otherwise, decrement sector number to get next 

possible free sector number. 

If there are no more sectors on this track, go to 

B265 to find a new track. 

Otherwise, rotate the track bit mask by one position 

and get the bit for this sector. 

If the sector is in use, loop back to B249. 

Otherwise, add one to file's sector count. 

Pass back sector number (track number is at B5F1) . 

And return to caller . 
B265 Indicate no track is being used at present. 
B26A Reset allocation flag to allow at least one complete 

search of all tracks for some space. 

Read VTOC sector . 
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B272 Get last track allocated from and add direction value 

to get next track to examine (+1 or -1) . 

Are we back to track 0? 

If so, go to B284. 

Otherwise, are we past track 34? 

If so, reverse direction and go to B28E. 
B284 Is this the second time we have come to track ? 

(check allocation flag) . 

If so, exit with "DISK FULL" error. 

Otherwise, set allocation flag to remember this. 

Set direction to forward (+1) . 
B28E Begin at directory track (17 + or - 1) . 

Compute bit map index (tracknumber*4) . 

Copy track bit map from VTOC to workarea, watching 

to see if all four bytes are zero (track is full) . 

In any case, set all four bytes in VTOC to zero 

(allocate all sectors) . 

If no free sectors in the track, go to B272 to try 

next track . 

Otherwise, write VTOC to disk to insure file's 

integrity. 

Set sector number to last sector in track. 

Go to B249 to allocate one of its free sectors to 

the file. 

B2C3-B2DC Release pre-allocated sectors in current track and 
checkpoint the VTOC. 

Has a track been allocated to the file? 
If not, exit to caller. 
Otherwise, read VTOC. 

Get next sector which could have been used (number 
of times track map was shifted during allocation) . 
Call B2DD to shift track bit map back and merge it 
back into the VTOC bit map. 
Indicate no track has been allocated. 
Exit to caller. 

B2DD-B2FF Free one or more sectors by shifting mask in file 
manager's allocation area back into VTOC bit map. 
(If CARRY is set, current sector is freed also) 
Rotate entire 4 byte track bit mask once. 
Repeat for as many sectors as were allocated. 
Compute index into VTOC for this track's map. 
If zero, exit. 

Merge ("OR") file manager's bits with those already 
in VTOC, freeing sectors which were never used by 
the file. 
Return to caller . 

B300-B35E Calculate file position. 

Set record number passed in file manager parmlist 

in workarea and in sector offsets. 

Clear sector offset high part. 

Perform a 16 bit multiply as follows: 

3 byte file position = record number times record 

length . 

Add the byte offset from the parmlist into the three 

byte file position value (B5E4 ,B5E5,B5E6) . 

Return to caller . 
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B35F-B37D Error exits. 

"LANGUAGE NOT AVAILABLE" 
"RANGE ERROR" (bad opcode) 
"RANGE ERROR" (bad subcode) 
"WRITE PROTECTED" 
"END OF DATA" 
"FILE NOT FOUND" 
"DISK FULL" (all files closed) 
B37B RC=A "FILE LOCKED" 

B37F-B396 Exit file manager. 

B37F Exit with no errors. 

Get return code of zero. 

Clear carry flag and go to B386. 
B385 Set carry flag to indicate error. 
B386 Save return code in parmlist. 

Clear monitor status register ($48) 

probably tromped on it. 

Save file manager workarea to file buffer 

Restore processor status and stack register. 

Exit to original caller of file manager. 
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B397-B3A3 File manager scratch space. 

B397 Track/sector of current directory sector (2 bytes) . 
B39B S register save area. 
B39C Directory index. 

B39D Catalog line counter/Directory lookup flag/Etc. 
B39E LOCK/UNLOCK mask/Allocation flag/Etc. 
B3A0 Four byte mask used by INIT to free an entire track 
in the VTOC bit map. 

B3A4-B3A6 Decimal conversion table (1,10,100). 

B3A7-B3AE File type name table used by CATALOG. 

File types are: T,I ,A,B,S ,R,A,B, corresponding to 
hex values: $00, $01, $02, $04, $08, $10, $20, and 
$40 respectively. 

B3AF-B3BA ASCII text "DISK VOLUME " backwards. Used by CATALOG. 



B3BB-B4BA 
B3BC 
B3BE 
B3C1 
B3E2 
B3EB 
B3EC 
B3EF 
B3F0 
B3F1 
B3F3 
B3F7 

B47B 



VTOC sector buffer. 

Track/sector of first directory sector. 

DOS release number (1, 2, or 3) . 

Volume number of diskette. 

Number of entries in each T/S List sector, 

Track to allocate next. 

Direction of track allocation (+1 or -1) 

Number of tracks on a disk. 

Number of sectors on a disk. 

Sector size in bytes (2 bytes) 

Track bit map 

Track 1 bit map 

etc. 

Track 34 bit map 
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B4BB-B5BA DIRECTORY sector buffer. 

B4BC Track/sector of next directory sector. 
B4C6 First directory entry and 

Track of T/S List 
B4C7 Sector of T/S List 
B4C8 File type and lock bit 
B4C9 Filename field (30 bytes) 
B4E7 Size of file in sectors (including T/S List(s)). 

B5BB-B5D0 File manager parameter list. 
B5BB Opcode 
B5BC Subcode 
B5BD Eight bytes of variable parameters depending on 

opcode . 
B5C5 Return code. 

B5C7 Address of file manager workarea buffer. 
B5C9 Address of T/S List sector buffer. 
B5CB Address of data sector buffer. 
B5CD Address of next DOS buffer on chain (not used) . 



B5D1-B5FD 
B5D1 
B5D3 
B5D5 



B5D6 
B5D8 
B5D9 

B5DA 
B5DC 
B5DE 
B5E0 
B5E2 
B5E4 

B5E8 
B5EA 
B5EC 
B5EE 
B5F0 



B5F6 
B5F7 
B5F8 
B5F9 
B5FA 



File manager workarea. 
1st T/S List sector's track/sector. 
Current T/S List sector's track/sector. 
Flags: 80=T/S List needs checkpoint 

40=Data sector needs checkpoint 
20=VTOC sector needs checkpoint 
02=Last operation was write 
Current data sector's track/sector. 
Directory sector index for file entry. 
Index into directory sector to directory entry for 
file. 

Number of sectors described by one T/S List. 
Relative sector number of first sector in list. 
Relative sector number +1 of last sector in list. 
Relative sector number of last sector read. 
Sector length in bytes. 

File position (3 bytes) sector offset, byte offset 
into that sector. 
Record length from OPEN. 
Record number . 
Byte offset into record. 
Number of sectors in file. 
Sector allocation area (6 bytes) . 
Next sector to allocate (shift count) 
Track being allocated 
Four byte bit map of track being allocated, rotated 

to next sector to allocate. 

File type. 

Slot number times 16. 

Drive number . 

Volume number (complemented) . 

Track number . 



B5FE-B5FF Not used. 
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B600-B6FF 
B600 

B65D 
B65D 
B65E 



B671 

B686 

B692 



B6FE 
B6FF 



Start of Boot 2/RWTS image. 

Boot 1 image which can be written to iNITed disks 

on track 0, sector 0. 

DOS 3.3 patch area. 

APPEND patch flag. 

APPEND patch. Come here when file manager driver 

gets an error other than end of data. 

Locate and free the file buffer. 

Clear the APPEND flag. 

Get the error number and go print error (A6D2) . 

APPEND patch. Come here from APPEND command handler 

to increment record number if APPEND flag is set and 

to clear the flag. Exit through POSITION. 

VERIFY patch. Come here from I/O a range of bytes 

routine to exit through VERIFY after SAVE or BSAVE. 

APPEND patch. Come here from file manager driver if 

return code was END OF DATA. 

Test the file position for zero. 

If non-zero, set APPEND flag on and return to caller. 

If zero (at start of file) , copy record number and 

byte offset to file manager parmlist and return a 

zero data byte to caller. 

Page address of first page in Boot 2. 

Number of sectors (pages) in Boot 2. 
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B700-B749 DOS 2nd stage boot loader. 

Set RWTS parmlist to read DOS from disk. 
Call Read/Write group of pages ($B793) . 
Create new stack. 

Call SETVID ($FE93) and SETKBD ($FE89) . 
Exit to DOS coldstart ($9D84) . 

B74A-B78C Put DOS on tracks 0-2. 

Set RWTS parmlist to write DOS to disk. 
Call Read/Write group of pages ($B793) . 
Exit to caller. 

B78D-B792 Unused. 

B793-B7B4 Read/Write a group of pages. 

call RWTS through external entry point ($B7B5) 
Exit to caller. 

B7B5-B7C1 Disable interrupts and call RWTS. 

B7C2-B7D5 Set RWTS parameters for writing DOS. 

B7D6-B7DE Zero current buffer. 

Zero 256 bytes pointed to by $42,$43. 
Exit to caller. 

B7DF-B7E7 DOS 2nd stage boot loader parmlist. 
B7DF Unused. 

B7E0 Number of pages in 2nd DOS load. 
B7E1 Number of sectors to read/write. 
B7E2 Number of pages in 1st DOS load. 
B7E3 INIT DOS page counter. 
B7E4 Pointer to RWTS parmlist (2 bytes) . 
B7E6 Pointer to 1st stage boot location (2 bytes) . 
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B7E8-B7F8 
B7E8 
B7E9 
B7EA 
B7EB 
B7EC 
B7ED 
B7EE 
B7F0 
B7F2 
B7F3 
B7F4 
B7F5 

B7F6 
B7F7 
B7F8 



RWTS parmlist. 

Table type. Must be $01. 

Slot number times 16. 

Drive number ($01 or $02) . 

Volume number expected (0 matches any volume) . 

Track number ($00 to $22) . 

Sector number ($00 to $0F) . 

Pointer to Device Characteristics Table (2 bytes) . 

Pointer to user data buffer for READ/WRITE (2 bytes) . 

Unused. 

Byte count for partial sector (use $00 for 256) . 

Command code: 0=SEEK, 1=READ, 2=WRITE, 4=FORMAT. 

Error code: (valid if carry set) $10=Write protect, 

$20=Volume mismatch, $40=Drive error, $08=INIT error, 

Volume number found . 

Slot number found . 

Drive number found. 



B7F9-B7FA Unused. 

B7FB-B7FE Device Characteristics Table (DCT) . 
B7FB Device type (should be $00) . 
B7FC Phases per track (should be $01) . 
B7FD Motor on time count (2 bytes - should be $EF, $D8) 



B7FF 



Unused . 
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B800-B829 PRENIBBLE routine. 

Converts 256 (8 bit) bytes to 342 (6 bit) "nibbles" 

of the form 00XXXXXX. 

Pointer to page to convert stored at $3E,$3F. 

Data stored at primary and secondary buffers. 

On entry: $3E,$3F contain pointer to user data. 

On exit: A-reg: unknown 

X-reg:$FF 

Y-reg:$FF 

Carry set 

Exit to caller. 

B82A-B8B7 WRITE routine. 

Writes prenibbilized data from primary and secondary 
buffers to disk. 
Calls Write a byte subroutine. 
Writes 5 bytes autosync, starting data marks 
($D5/$AA/$AD) , 342 bytes data, one byte checksum, and 
closing data marks ($DE/$AA/$EB) . 

Uses Write Translate Table ($BA29) . 
On entry: X-reg:Slot number times 16 
On exit: Carry set if error 

If no error: 

A-reg: unknown 

X-r eg : unchanged 

Y-reg:$00 

Carry clear 

Uses $26, $27, $678 
Exit to caller. 

B8B8-B8C1 Write a byte subroutine. 

Timing critical code used to write bytes at 32 cycle 
intervals. 



Exit to caller. 
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B8C2-B8DB POSTNIBBLE routine. 

Converts 342 (6 bit) "nibbles" of the form OOXXXXXX 

to 256 (8 bit) bytes. 

Nibbles stored at primary and secondary buffers. 

Pointer to data page stored at $3E,$3F. 

On entry: X-reg:Slot number times 16 

$3E, $3F:pointer to user data 

$26:byte count in secondary buffer ($00) 
On exit: A-reg:unknown 

X-reg : unknown 

Y-reg:byte count in secondary buffer 

Carry set 
Exit to caller. 

B8DC-B943 READ routine. 

Read a sector of data from disk and store it at 
primary and secondary buffers. (First uses secondary 
buffer high to low, then primary low to high) 
On entry: X-reg:Slot times 16 

Read mode (Q6L,Q7L) 
On exit: Carry set if error. 

If no error: 

A-reg:$AA 

X-reg :unchanged 

Y-reg:$00 

Carry clear 

Uses $26 
Exit to caller. 

B944-B99F RDADR routine. 

Read an Address Field. 

Reads starting address marks ($D5/$AA/$96) , address 

information (volume/track/sector/checksum) , and 

closing address marks ($DE/$AA) . 

On entry: X-reg:Slot number times 16 

Read mode (Q6L,Q7L) 
On exit: Carry set if error. 

If no error: 

A-reg:$AA 

X-reg :unchanged 

Y-reg:$00 

Carry clear 

$2F: Volume number found 

$2E: Track number found 

$2D: Sector number found 

$2C: Checksum found 

Uses $26, $27 
Exit to caller. 

B9A0-B9FF SEEKABS routine. 

Move disk arm to desired track. 

Calls arm move delay subroutine ($BA00) . 

On entry: X-reg :Slot number times 16 

A-reg:Desired track (halftrack for single 

phase disk) . 
$478:Current track. 
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On exit: A-reg :unknown 

X'-reg: unchanged 

Y-reg: unknown 

$2A and $478:Final track 

$27:Prior track (if seek needed) 

Uses: $26,$27,$2A,$2B 
Exit to caller. 

BAOO-BA10 Arm move delay subroutine. 

Delays a specified number of 100 Usee intervals. 
On entry: A-reg:number of 100 Usee intervals. 

$46 ,$47:Should contain motor on time count 

($EF,$D8) from Device Characteristics Table 

$478:Current track. 
On exit: A-reg:$00 

X-reg:$00 

Y-reg : unchanged 

Carry set 
Exit to caller. 

BA11-BA28 Arm move delay table. 

Contains values of 100 Usee intervals used during 
Phase-on and Phase-off of stepper motor. 

BA29-BA68 Write Translate Table. 

Contains 6 bit "nibbles" used to convert 8 bit bytes. 
Values range from $96 to $FF. 

Codes with more than one pair of adjacent zeros or 
with no adjacent ones are excluded. 

BA69-BA95 Unused. See note on page 8-41. 

BA96-BAFF Read Translate Table. 

Contains 8 bit bytes used to convert 6 bit "nibbles". 
Values range from $96 to $FF. 

Codes with more than one pair of adjacent zeros or 
with no adjacent ones are excluded. 

BB00-BBFF Primary Buffer. 
BC00-BC55 Secondary Buffer. 

BC56-BCC3 Write Address Field during initialization. 
Calls Write double byte subroutine. 

Writes number of autosync bytes contained in Y-reg, 
starting address marks ($D5/$AA/$96) , address 
information (volume/track/sector/checksum) , closing 
address marks ($DE/$AA/$EB) . 
On entry: X-reg:Slot number times 16 

Y-reg:number of autosync to write 

$3E: $AA 

$3F: sector number 

$41: volume number 

$44: track number 
On exit: A-reg :unknown 

X-reg: unchanged 

Y-reg:$00 

Carry set 
Exit to caller. 
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BCC4-BCDE Write double byte subroutine. 

Timing critical code that encodes address information 
into even and odd bits and writes it at 32 cycle 
intervals. 
Exit to caller. 

BCDF-BCFF Unused. 

BD00-BD18 Main entry to RWTS. 

Upon entry, store Y-reg and A-reg at $48, $49 as 

pointers to the IOB. 

Initialize maximum number of recals at 1 and seeks 

at 4. 

Check if the slot number has changed. If not, 

branch to SAMESLOT at $BD34. 
BD19-BD33 Update slot number in IOB and wait for old drive 

to turn off . 
BD34-BD53 SAMESLOT 

Enter read mode and read with delays to see if disk 

is spinning. 

Save result of test and turn on motor just in case. 
BD54-BD73 Move pointers in IOB to zero page for future use. 

Device Characteristics Table pointer at $3C,$3D 

and data buffer pointer at $3E,$3F. 

Set up $47 (motor on time) with $D8 from DCT. 

Check if the drive number has changed. If not, 

branch to $BD74. 

If so, change test results to show drive off. 
BD74-BD8F Select appropriate drive and save drive being used 

as high bit of $35. l=drive 1, 0=drive 2. 

Get test results. If drive was on, branch to $BD90. 

Wait for capacitor to discharge using MSWAIT 

subroutine at $BA00. 
BD90-BDAA Get destination track and go to it using MYSEEK 

subroutine at $BE5A. 

Check test result again and if drive was on, 

branch to TRYTRK at $BDAB. 

Delay for motor to come up to speed. 
BDAB-BDBB TRYTRK 

Get command code. 

If null, exit through ALLDONE at $BE46, turning drive 

off and returning to caller. 

If =4, branch to FORMDSK at $BE0D. 

Otherwise, move low bit into carry (set=read, 

clear=write) and save value on status reg. 

If write operation, data is prenibbilized via a call 

to PRENIB16 at $B800. 
BDBC-BDEC Initialize maximum retries at 48 and read an 

Address Field via RDADR16 at $B944. 

If read was good, branch to RDRIGHT at $BDED. 

If bad read, decrement retries, and, if still some 

left try again. Else, prepare to recalibrate. 

Decrement recal count. If no more, then indicate 

drive error via DRVERR at $BE04. 

Otherwise, reinitialize reseeks at 4 and recalibrate 

arm. Move to desired track and try again. 
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BDED-BE03 



If so branch to RTTRK 



W\ ^ 



BE04-BE0A 



9 BEOB-BEOC 
BEOD-BFOF 

<4 



BE10-BE25 
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then no error. 

match, load A-reg with 

and exit via HNDLERR 
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BE26-BE45 
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BE46-BE47 
BE48-BE50 

^BE51-BE59 

H 

2JBE5A-BE8D 

5JBE8E-BE94 
■^BE95-BEAE 



RDRIGHT 

Verify on correct track. 

at $BE10. 

If not, set correct track via SETTRK subroutine at 

$BE95 and decrement reseek count. 

If not zero then reseek track. If zero, then recal. 

DRVERR 

Clean up stack and status reg. 

Load A-reg with $40 (drive error) 

Goto HNDLERR at $BE48. 

Used to branch to ALLDONE at $BE46. 

FORMDSK 

Jump to DSKFORM at $BEAF . 

RTTRK 

Check volume number found against volume number 

wanted . 

If no volume was specified, 

If specified volume doesn't 

$20 (volume mismatch error) 

at $BE48. 

CRCTVOL 

Check to see if sector is correct. 

Use ILEAV table at $BFB8 for software sector 

interleaving. 

If wrong sector, try again by branching back to 

TRYADR at $BDC1. 

If sector correct, find out what operation to do. 

If write, branch to WRIT at $BE51. 

Otherwise, read data via READ16 ($B8DC) . 

If read is good, then postnibble data via POSTNB16 

($B8C2) and return to caller with no error. 

ALLDONE 

Skip over set carry instruction in HNDLERR. 

HNDLERR 

Set carry. 

Store A-reg in IOB as return code. 

Turn off motor. 

Return to caller. 

WRITE 

Write a sector using WRITE16 ($B82A) . 

If the write was good, exit via ALLDONE ($BE46) . 

If bad write, load A-reg with $10 (write protect 

error) and exit via HNDLERR ($BE48) . 

MYSEEK 

Provides necessary housekeeping before going to 

SEEKABS routine. 

Determines number of phases per track and stores 

track information in appropriate slot dependent 

location. 

XTOY routine. 

Put slot in Y-reg by transferring X-reg divided 

by 16 into Y-reg. 

Set track number. 
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BEAF-BFOC INIT command handler 

Provides setup for initializing a disk. 

Get the desired volume number from the IOB. 

Zero both the primary and secondary buffers. 

Recalibrate the disk arm to track 0. 

Set the number of sync bytes to be written between 

sectors to $28 (40.) . 

Call TRACK WRITE routine for the actual formatting. 

Allow 48 retries during initialization. 

Double check that the first sector found is zero 

after calling TRACK WRITE. 

Increment the track number after successfully 

formatting a track. 

Loop back until 35 tracks are done. 
BF0D-BF61 TRACK WRITE routine. 

Start with sector zero. 

Preceed it with 128 self-sync bytes. 

Follow them with sectors through 15 in sequence. 

Set retry count for verifying the track at 48. 

Fill the sector initilization map with positive 

numbers. 

Loop through a delay period to bypass most of the 

initial self^sync bytes. 

Read the first Address Field found. 

If the read is good and sector zero was found, 

enter the VERIFY TRACK routine. 

Decrement the sync count by 2 (until it reaches 16 

at which time it is decremented by 1) . 

If sync count is greater than or equal to 5, exit 

via $BF71. 

If not, set carry and return to caller. 
BF62-BF87 VERIFY TRACK routine. 

This routine reads all 16 sectors from the track that 

was just formatted. 

If an error occurs during the read of either the 

Address Field or the Data Field, the number of 

retries is decremented. 

The routine continues reading until retries is zero. 

Calls Sector Map routine ($BF88) . 
BF88-BFA7 Sector Map routine. 

This routine marks the sector initialization map as 

each sector is verified. 

If an error occurs, the routine exits through $BF6C , 

which decrements the number of retries and continues 

if that value is greater than zero. 

Upon completion of track zero, the sync count is 

decremented by two if it is at least 16. 

BFA8-BFB7 Sector Initialization Map used to mark sectors as 
they are initialized. 

Contains a $30 prior to initialization of a track. 

Value changed to $FF as each sector is completed. 

BFB8-BFC7 Sector Translate Table 

Sector interleaving done with software. 
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BFC8-BFD8 Patch area starts here. 

Patch from $B741 to zero language card during boot. 

Call SETVID ($FE93) . 

Unprotect Language Card (if present) . 

Store $00 at $E0O0. 

Exit through SETKBD ($FE89) and DOS coldstart. 

Unused. See note below. 



Patch called from $A0E2. 

Set three additional defaults (Byte offset=0) . 

Return to caller. 

Patch called from $A6D5. 

Call $A75B to reset state and set warmstart flag. 

Mark RUN not interrupted. 

Return to caller . 
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BFD9- 


-BFDB 
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BFDC- 


-BFE5 


H 


BFE6 


-BFEC 



BFED-BFFF Patch called from $B377. 

Call $AE7E to save file manager workarea. 

Restore stack. 

Close all open files ($A316) . 

Save stack again. 

Exit through $B385 ("DISK FULL ERROR"). 



NOTE: In January 1983, minor revisions were made to DOS 3.3 
(see page 2-4), The area from BA69-BA93, which was 
previously unused, was used to add three new patches. The 
second of these patches is an extension of the previous 
patch at $BFC8, and requires the use of $BFD9-$BFDB, 
previously unused. The three patches are documented below. 

BA69-BA75 Patch called from $A6BB . 

Clears the APPEND flag ($B65D) if last command 
was APPEND. Return to caller. 

BA76-BA81 Patch called from $BFD6. 

Set MODE flag to $FF (used by Apple 80-column 
firmware). Turn off 80-column display. 
Turn off alternate character set. 
Exit through $FB2F (Monitor INIT). 

BA84-BA93 Patch called from $B683. 

Set file manager parameters, byte offset, and 
record number to zero. Save stack in stack 
register save area. 
Exit through $B37F (exit file manager). 

In addition, the calculate file position routine ( $B300- 
$B35E) has been modified to clear the carry before adding 
the byte offset to the current byte position. 
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DOS ZERO PAGE USAGE 



BYTE 

24 

26,27 

28,29 
2A 

2B 

2C 

2D 

2E 

2F 

33 

35 

36,37 

38,39 

3C 



3D 

3E.3F 

40,41 

41 

42,43 

44,45 

46,47 

48,49 

4A,4B 

4C,4D 

67,68 

69, 6A 

6F,70 

73,74 

76 

AF,B0 

CA,CB 

CC,CD 

D6 

D8,D9 



USE 

Cursor horizontal (DOS) 

Sector read buffer address (ROM) 

Scratch space (RWTS) 

BASL/BASH (DOS) 

Segment merge counter (ROM, BOOT) 

Scratch space (RWTS) 

BOOT slot* 16 (ROM) 

Scratch space (RWTS) 

Checksum from sector header (RWTS) 

Sector number from sector header (RWTS) 

Track number from sector header (RWTS) 

Volume number from sector header (RWTS) 

Prompt character (DOS) 

Drive number in high bit (RWTS) 

CSWL,CSWH (DOS) 

KSWL,KSWH (DOS) 

Workbyte (ROM) 

Merge workbyte (BOOT) 

Device characteristics table address (RWTS) 

Sector number (ROM) 

Device characteristics table address (RWTS) 

Address of ROM sector-read subroutine (BOOT) 

Buffer address (RWTS) 

DOS image address (BOOT) 

File buffer address (DOS) 

Format track counter (RWTS) 

Buffer address (DOS) 

Numeric operand (DOS) 

Scratch space (RWTS) 

IOB address (RWTS) 

INTEGER BASIC LOMEM address (DOS) 

Format diskette workspace (RWTS) 

INTEGER BASIC HIMEM address (DOS) 

APPLESOFT BASIC PROGRAM START (DOS) 

APPLESOFT BASIC VARIABLES START (DOS) 

APPLESOFT BASIC STRING START (DOS) 

APPLESOFT BASIC HIMEM address (DOS) 

APPLESOFT BASIC line number high (DOS) 

APPLESOFT BASIC PROGRAM END (DOS) 

INTEGER BASIC PROGRAM START (DOS) 

INTEGER BASIC VARIABLES END (DOS) 

APPLESOFT BASIC PROGRAM protection flag (DOS) 

INTEGER BASIC line number (DOS) 

APPLESOFT BASIC ONERR (DOS) 
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This section is intended to supply the reader with utility 
programs which can be used to examine and repair diskettes. 
These programs are provided in their source form to serve as 
examples of the programming necessary to interface practical 
programs to DOS. The reader who does not know assembly 
language may also benefit from these programs by entering 
them from the monitor in their binary form and saving them 
to disk for later use. It should be pointed out that the 
use of 16 sector diskettes is assumed, although most of the 
programs can be easily modified to work under any version of 
DOS. It is recommended that, until the reader is completely 
familiar with the operation of these programs, he would be 
well advised to use them only on an "expendable" diskette. 
None of the programs can physically damage a diskette, but 
they can, if used improperly, destroy the data on a 
diskette, requiring it to be re-INITialized. 

Five programs are provided: 



DUMP TRACK DUMP UTILITY 

This is an example of how to directly access the 
disk drive through its I/O select addresses. DUMP 
may be used to dump any given track in its raw, 
prenibbilized form, to memory for examination. This 
can be useful both to understand how disks are 
formatted and in diagnosing clobbered diskettes. 

ZAP DISK UPDATE UTILITY 

This program is the backbone of any attempt to patch 
a diskette directory back together. It is also 
useful in examining the structure of files stored on 
disk and in applying patches to files or DOS 
directly. ZAP allows its user to read, and 
optionally write, any sector on a diskette. As 
such, it serves as a good example of a program which 
calls Read/Write Track/Sector (RWTS) . 
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INIT 



REFORMAT A SINGLE TRACK 

w 

This program will initialize a single track on a 
diskette. Any volume number ($00-$FF) may be ^ 
specified. INIT is useful in restoring a track whose'—' 
sectoring has been damaged without reinitializing 
the entire diskette. DOS 3.3 and 48K is assumed. 6r 



For example . . . 

SI 

■^ 0800:20 DC 03 112 COPY 



JSR LOCFPL 



FIND PARMLIST 



FTS 



COPY 



FIND T/S LISTS UTILITY 

FTS may be used when the directory for a diskette 
has been destroyed. It searches every sector on a 
diskette for what appear to be Track/Sector Lists, 
printing the track and sector location of each it 
finds. Knowing the locations of the T/S Lists can 
help the user patch together a new catalog using 
ZAP. 

CONVERT FILES 

COPY is provided as an example of direct use of the 
DOS File Manager package from assembly language. 
The program will read an input B-type file and copy 
its contents to an output T-type file. Although it 
could be used, for example, to convert files used by 
the Programma PIE editor for use by the Apple 
Toolkit assembler, it is not included as a utility 
program but rather as an example of the programming 
necessary to access the File Manager. 



STORING THE PROGRAMS ON DISKETTE 
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>| indicates that the binary code "20DC03" should be stored at 
0800 and that this is statement 112. To enter a program in 
_ the monitor, the reader must type in each address and its 
51 corresponding object code. The following is an example of 
how to enter the DUMP program: 



CALL -151 
0800:20 E3 03 
0803:84 00 
0805:85 01 
0807:A5 02 

. . .etc. . . 

0879:85 3F 

087B:4C -B3 FD 

BSAVE DUMP,A$800,L$7E 



(Enter the monitor from BASIC) 



(Save program to disk) 



E 3 



Note that if a line (such as line 4 in DUMP) has no object 
bytes associated with it, it may be ignored. When the 
program is to be run... 



BLOAD DUMP 
CALL -151 
02:11 N 800G 



(Load program) 

(Get into monitor) 

(Store track to dump, run program) 



£i j^| The BSAVE commands which must be used with the other 



The enterprising programmer may wish to type the source code 
for each program into an assembler and assemble the programs 
onto disk. The Apple Toolkit assembler was used to produce « 
the listings presented here, and interested programmers ™ 
should consult the documentation for that assembler for more 
information on the pseudo-opcodes used. For the 
non-assembly language programmer, the binary object code of 
each program may be entered from the monitor using the 
following procedure. 



programs are: 

■I BSAVE ZAP,A$900,L$6C 
BSAVE INIT,A$800,L$89 
BSAVE FTS,A$900,L$DC 
BSAVE COPY,A$800,L$1EC 



mi 



The assembly language listings consist of columns of 
information as follows: 

The address of some object code 

The object code which should be stored there 

The statement number 

The statement itself 



A diskette containing these five programs is available at a 
reasonable cost directly from Quality Software, 6660 Reseda 
Blvd., Reseda, CA or telephone (213) 344-6599. 

Also available from Quality Software is an expanded version 
of these utilities called BENEATH APPLE DOS' BAG OF TRICKS. 
See the page facing 1-1 for' more details. 
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DUMP — TRACK DUMP UTILITY 



The DUMP program will dump any track on a diskette in its 
raw, pre-nibbilized format, allowing the user to examine the 
sector address and data fields and the formatting of the 
track. This allows the curious reader to examine his own 
diskettes to better understand the concepts presented in the 
preceeding chapters. DUMP may also be used to examine most 
protected disks to see how they differ from normal ones and 
to diagnose diskettes with clobbered sector address or data 
fields with the intention of recovering from disk I/O 
errors. The DUMP program serves as an example of direct use 
of the DISK II hardware from assembly language, with little 
or no use of DOS . 

To use DUMP, first store the number of the track you wish 
dumped at location $02, then begin execution at $800. DUMP 
will return to the monitor after displaying the first part 
of the track in hexadecimal on the screen. The entire track 
image is stored, starting at $1000. For example: 

CALL -151 (Get into the monitor from BASIC) 

BLOAD DUMP (Load the DUMP program) 

...Now insert the diskette to be dumped... 
02:11 N 800G (Store a 11 (track 17, the catalog 

track) in $02, N terminates the store 
command, go to location $800) 

The output might look like this... 

1000- D5 AA 96 AA AB AA BB AB 

1008- AA AB BA DE AA E8 CO FF 

1010- 9E FF FF FF FF FF D5 AA 

1018- AD AE B2 9D AC AE 96 96 
. . .etc . . . 



K 4 



(Start of sector address) 

(Start of sector data) 
(Sector data) 



Quite often, a sector with an I/O error will have only one 
bit which is in error, either in the address or data header 
or in the actual data itself. A particularly patient 
programmer can, using DUMP and perhaps a half hour of hand 
"nibbilizing" determine the location of the error and record 
the data on paper for later entry via ZAP. A thorough 
understanding of Chapter 3 is necessary to accomplish this 
feat. 



s 3 

m 3 
m ^ 
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i ^ 

1 



0800: 

0800 
0800 
0800 
0800 
0800 
0800 
0800 
0800 
0800 
0800 
0800 
0800 
0800 
0800 

0800: 

0000 
0002 
003C 
003E 
0048 

0800: 

1000 
03E3 
03D9 
FDED 
FDB3 

0800: 

C080 
C081 
C082 
C083 
C084 
C085 
C086 
C087 
C088 
C089 
C08A 
C08B 
C08C 
C08D 
C08E 
C08F 

0800: 

0000 
0000 
0001 
0002 
0003 
0004 
0005 
0006 
0008 
O00A 
000C 
0000 
0001 
0002 
0004 
OOOD 
0010 
0020 
0040 
0080 



************ 



ORG $800 



4 ********************************************** 

5 * * 

6 * DUMP:THIS PROGRAM WILL ALLOW ITS USER TO DUMP AN ENTIRE * 

7 * TRACK IN ITS RAW FORM INTO MEMORY FOR EXAMINATION * 

8 * * 

9 * INPUT: $02 = TRACK TO BE READ * 

10 * * 

11 * OUTPUT: $1000 = ADDRESS OF TRACK IMAGE * 

12 * * 

13 * ENTRY POINT: $800 * 

14 * * 

15 * PROGRAMMER: DON D WORTH 2/19/81 * 

16 * * 
^7 *********************************************************** 



19 



ZPAGE DEFINITIONS 



21 


PTR 


EQU 


$0 


WORK POINTER 


22 


TRACK 


EQU 


$2 


TRACK TO BE READ/WRITTEN 


23 


AIL 


EQU 


$3C 


MONITOR POINTER 


24 


A2L 


EQU 


$3E 


MONITOR POINTER 


25 


PREG 


EQU 


$48 


MONITOR STATUS REGISTER 


27 


* 


OTHER ADDRESSES 


29 


BUFFER 


EQU 


$1000 


TRACK IMAGE AREA 


30 


LOCRPL 


EQU 


$3E3 


LOCATE RWTS PARMLIST SUB 


31 


RWTS 


EQU 


$3D9 


RWTS SUBROUTINE 


32 


COUT 


EQU 


$FDED 


PRINT ONE CHAR SUBROUTIN 


33 


XAM 


EQU 


$FDB3 


MONITOR HEX DUMP SUBRTN 


35 


* 


DISK 


I/O SELECTS 


37 


DRVSM0 


EQU 


$C080 


STEP MOTOR POSITIONS 


38 


DRVSM1 


EQU 


$C081 




39 


DRVSM2 


EQU 


$C082 




40 


DRVSM3 


EQU 


$C083 




41 


DRVSM4 


EQU 


$C084 




42 


DRVSM5 


EQU 


$C085 




43 


DRVSM6 


EQU 


$C086 




44 


DRVSM7 


EQU 


$C087 




45 


DRVOFF 


EQU 


$C088 


TURN DRIVE OFF AFTER 6 R 


46 


DRVON 


EQU 


$C089 


TURN DRIVE ON 


47 


DRVSL1 


EQU 


$C08A 


SELECT DRIVE 1 


48 


DRVSL2 


EQU 


$C08B 


SELECT DRIVE 2 


49 


DRVRD 


EQU 


$C08C 


READ DATA LATCH 


50 


DRVWR 


EQU 


$C08D 


WRITE DATA LATCH 


51 


DRVRDM 


EQU 


$C08E 


SET READ MODE 


52 


DRVWRM 


EQU 


$C08F 


SET WRITE MODE 


54 


* 


RWTS 


PARMLIST 


DEFINITION 


56 




DSECT 




57 


RPLIOB 


DS 


1 


IOB TYPE ($01) 


58 


RPLSLT 


DS 


1 


SLOT* 16 


59 


RPLDRV 


DS 


1 


DRIVE 


60 


RPLVOL 


DS 


1 


VOLUME 


61 


RPLTRK 


DS 


1 


TRACK 


62 


RPLSEC 


DS 


1 


SECTOR 


63 


RPLDCT 


DS 


2 


ADDRESS OF DCT 


64 


RPLBUF 


DS 


2 


ADDRESS OF BUFFER 


65 


RPLSIZ 


DS 


2 


SECTOR SIZE 


66 


RPLCMD 


DS 


1 


COMMAND CODE 


67 


RPLCNL 


EQU 


$00 


NULL COMMAND 


68 


RPLCRD 


EQU 


$01 


READ COMMAND 


69 


RPLCWR 


EQU 


$02 


WRITE COMMAND 


70 


RPLCFM 


EQU 


$04 


FORMAT COMMAND 


71 


RPLRCD 


DS 


1 


RETURN CODE 


72 


RPLRWP 


EQU 


$10 


WRITE PROTECTED 


73 


RPLRVM 


EQU 


$20 


VOLUME MISMATCH 


74 


RPLRDE 


EQU 


$40 


DRIVE ERROR 


75 


RPLRRE 


EQU 


$80 


READ ERROR 



A-5 



OOOE 


76 RPLTVL 


DS 1 


OOOF 


77 RPLPSL 


DS 1 


OOIO 


78 RPLPDR 


DS 1 


0800 


79 


DEND 



TRUE VOLUME 
PREVIOUS SLOT 
PREVIOUS DRIVE 



0800: 

0800:20 E3 03 
0803:84 00 
0805:85 01 

0807:A5 02 
0809:A0 04 
080B:91 00 

080D:A9 00 
080F:A0 0C 
0811:91 00 

0813:A9 00 
0815:A0 03 
0817:91 00 
0819:20 E3 03 
081C:20 D9 03 
081F:A9 00 
0821:85 48 

0823: 

0823:A0 01 
0825:B1 00 
8 27 :AA 
0828:BD 89 CO 
082B:BD 8E CO 

082E:A9 00 

0830:85 00 

0832:A9 10 

0834:85 01 

0836:A0 00 

0838: 
0838: 

0838:BD 8C CO 
083B:10 FB 
083D:C9 FF 
083F:D0 F7 
0841:BD 8C CO 
0844:10 FB 
0846:C9 FF 
0848:D0 EE 
084A:BD 8C CO 
084D:10 FB 
084F:C9 FF 
0851:FO F7 
0853:D0 



0855 
0855 
0855 



5 



USE RWTS TO POSITION THE ARM TO THE DESIRED TRACK 



33 DUMP 
34 

3 5 



91 

92 
93 

95 
9 6 
97 
98 
99 
100 
101 



JSR LOCRPL 

STY PTR 

STA PTR+1 

LDA TRACK 

LDY #RPLTRK 

STA (PTR) ,Y 

LDA #RPLCNL 

LDY #RPLCMD 

STA (PTR) ,Y 

LDA #0 

LDY #RPLVOL 

STA (PTR) ,Y 

JSR LOCRPL 

JSR RWTS 

LDA #0 

STA PREG 



LOCATE RWTS PARMLIST 
AND SAVE POINTER 



GET TRACK TO READ/WRITE 
STORE IN RWTS LIST 



NULL OPERATION 
AND STORE IN LIST 



ANY VOLUME WILL DO 



RELOAD POINTER TO PARMS 
CALL RWTS 





^ j 


■^ 



103 * 

105 
106 
107 
108 
109 

111 
112 
113 
114 
115 

117 * 

118 * 

120 LOOP1 

121 

122 

123 

124 LOOP2 

125 

126 

127 

128 LOOP3 

129 

130 

131 

132 

134 * 

135 * 

136 * 



FIX P REG SO DOS IS HAPPY 

PREPARE TO DUMP TRACK TO MEMORY 

LDY #RPLSLT GET SLOT* 16 

LDA (PTR) ,Y 

TAX 

LDA DRVON,X KEEP DRIVE ON 

LDA DRVRDM.X INSURE READ MODE 

LDA #>BUFFER POINT AT DATA 



STA 
LDA 
STA 
LDY 



PTR 

#<BUFFER 
PTR+1 
#0 



START DUMPING AT THE BEGINNING OF A SECTOR ADDRESS 
FIELD OR A SECTOR DATA FIELD 



LDA 
BPL 
CMP 
BNE 

LDA 
BPL 
CMP 
BNE 
LDA 
BPL 
CMP 
BEQ 
BNE 



DRVRD , X 
LOOP1 
#$FF 
LOOP1 
DRVRD, X 
LOOP 2 
#$FF 
LOOP1 
DRVRD , X 
LOOP 3 
#$FF 
LOOP 3 
LOOP 4 



WAIT FOR NEXT BYTE 

AUTOSYNC? 

NO, DON'T START IN MIDDLE 

WAIT FOR NEXT BYTE 

TWO AUTOSYNCS? 
NOT YET 



STILL AUTOSYNCS? 

YES, WAIT FOR DATA BYTE 

ELSE, START STORING DATA 



ONCE ALIGNED, BEGIN COPYING THE TRACK TO MEMORY. 
COPY AT LEAST TWICE ITS LENGTH TO INSURE WE GET IT 
ALL. 



0855 :BD 8C CO 138 LOOPD 

0858:10 FB 139 

085A:91 00 140 LOOP4 

085C:E6 00 141 

085E:D0 F5 142 

0860:E6 01 143 

0862:A5 01 144 

0864:C9 40 145 

0866:90 ED 146 

0868:BD 88 CO 147 



LDA 
BPL 
STA 
INC 
BNE 
INC 
LDA 
CMP 
BCC 
LDA 



DRVRD, X 

LOOPD 

(PTR) ,Y 

PTR 

LOOPD 

PTR+1 

PTR+1 

#$40 

LOOPD 

DRVOFF,} 



WAIT FOR NEXT DATA BYTE 

STORE IN MEMORY 
BUMP POINTER 



DONE AT LEAST A TRACK? 
NO, CONTINUE 
TURN DRIVE OFF 



fe si 

Is- =i 

— »>! J^m 
l*iik.„:..^J 

fell. .^S 



86B: 

i6B:A9 
)6D:85 
!6F:A9 
i71:85 
!73:A9' AF 
!75:85 3E 
S77:A9 
!79:85 



00 
3C 

10 
3D 



10 
3F 



149 * WHEN FINISHED, DUMP SOME OF TRACK IN HEX ON SCREEN 

151 EXIT LDA #>BUFFER DUMP 800. 8AF 

152 STA AIL 

153 LDA #<BUFFER 

154 STA AJL+1 

155 LDA #>BUFFER+$AF 

156 STA A2L 

157 LDA #<BUFFER+$AF 

158 STA A2L+1 

159 JMP XAM EXIT VIA HEX DISPLAY 



087B:4C B3 FD 

*** SUCCESSFUL ASSEMBLY: NO ERRORS 



A-6 
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ZAP — DISK UPDATE UTILITY 



The next step up the ladder from DUMP is to access data on 
the diskette at the sector level. The ZAP program allows 
its user to specify a track and sector to be read into 
memory. The programmer can then make changes in the image of 
the sector in memory and subsequently use ZAP to write the 
modified image back over the sector on disk. ZAP is 
particularly useful when it is necessary to patch up a 
damaged directory. Its use in this regard will be covered 
in more detail when FTS is explained. 

To use ZAP, store the number of the track and sector you 
wish to access in $02 and $03 respectively. Tracks may 
range from $00 to $22 and sectors from $00 to $0F. For 
example, the Volume Table of Contents (VTOC) for the 
diskette may be examined by entering $11 for the track and 
$00 for the sector. $04 should be initialized with either a 
$01 to indicate that the sector is to be read into memory, 
or $02 to ask that memory be written out to the sector. 
Other values for location $04 can produce damaging results 
($04 in location $04 will INIT your diskette!) . When these 
three memory locations have been set up, begin execution at 
$900. ZAP will read or write the sector into or from the 
256 bytes starting at $800. For example: 

CALL -151 (Get into the monitor from BASIC) 

BLOAD ZAP (Load the ZAP program) 

...Now insert the diskette to be zapped... 

02:11 00 01 N 900G (Store a 11 (track 17, the catalog 

track) in $02, a 00 (sector 0) at $03, 
and a 01 (read) at $04. N ends the 
store command and 900G runs ZAP.) 

The output might look like this... 

0800- 04 11 OF 03 00 00 01 00 (Start of VTOC) 

0808- 00 00 00 00 00 00 00 00 

0810- 00 00 00 00 00 00 00 00 

0818- 00 00 00 00 00 00 00 00 
. . .etc . . . 

In the above example, if the byte at offset 3 (the version 
of DOS which INITed this diskette) is to be changed, the 
following would be entered... 



803:02 
04:02 N 900G 



(Change 03 to 02) 

(Change ZAP to write mode and do it) 



Note that ZAP will remember the previous values in $02, $03, 
and $04. 
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m 

E 

fc 

E 

E; 

E 
fc 

E: 

E 

E 
E 

E: 

E 

El. 

E' 

E" 

& 

E 

§)-. 

EL 
E- 



3 

a: 



=1 
3 



If something is wrong with the sector to be read (an I/O 
error, perhaps), ZAP will print an error message of the 
form: 

RC=10 

A return code of 10, in this case, means that the diskette 
was write protected and a write operation was attempted. 
Other error codes are 20 - volume mismatch, 40 - drive 
error, and 80 - read error. Refer to the documentation on 
RWTS given in Chapter 6 for more information on these 
errors . 



0900: 

0900 

0900 
0900 
0900 
0900 
0900 
0900 
0900 
0900 
0900 
0900 
0900 
0900 
0900 
0900 
0900 



0900: 

0000 
0002 
0003 
0004 
0001 
0002 
003C 
003E 
0048 

0900: 

0800 
03E3 
03D9 
FDED 
FDDA 
FDB3 

0900: 

0000 
0000 
0001 
0002 
0003 
0004 
0005 
0006 
0008 
000A 
000C 
0000 



2 ORG $900 

4 ****************************************** ***************** 

5 * * 

6 * ZAP: THIS PROGRAM WILL ALLOW ITS USER TO READ/WRITE * 

7 * INDIVIDUAL SECTORS FROM/TO THE DISKETTE * 

8 * * 

9 * INPUT: $02 = TRACK TO BE READ * 

10 * $03 = SECTOR TO BE READ/WRITTEN * 

11 * $04 = $01 - READ SECTOR * 

12 * $02 - WRITE SECTOR * 

13 * $800 = ADDRESS OF SECTOR DATA BUFFER * 

14 * * 

15 * ENTRY POINT: $900 * 

16 * * 

17 * PROGRAMMER: DON D WORTH 2/15/81 * 

18 * * 

19 *********************************************************** 



21 BELL EQU $87 BELL CHARACTER 
23 * ZPAGE DEFINITIONS 



25 


PTR 


EQU 


$0 


26 


TRACK 


EQU 


$2 


27 


SECTOR 


EQU 


$3 


28 


OPER 


EQU 


$4 


29 


READ 


EQU 


1 


30 


WRITE 


EQU 


2 


31 


AIL 


EQU 


?3C 


32 


A2L 


EQU 


$3E 


33 


PREG 


EQU 


$48 


3 5 


* 


OTHER ADDR 


37 


BUFFER 


EQU 


$800 


38 


LOCRPL 


EQU 


$3E3 


39 


RWTS 


EQU 


$3D9 


40 


COUT 


EQU 


$FDED 


41 


PRBYTE 


EQU 


$FDDA 


42 


XAM 


EQU 


$FDB3 


44 


* 


RWTS 


PARML 


46 




DSECT 


47 


RPLIOB 


DS 


1 


48 


RPLSLT 


DS 


1 


49 


RPLDRV 


DS 


1 


50 


RPLVOL 


DS 


1 


51 


RPLTRK 


DS 


1 


52 


RPLSEC 


DS 


1 


53 


RPLDCT 


DS 


2 


54 


RPLBUF 


DS 


2 


55 


RPLSIZ 


DS 


2 


56 


RPLCMD 


DS 


1 


57 


RPLCNL 


EQU 


$00 



WORK POINTER 
TRACK TO BE READ/WRITTEN 
SECTOR TO BE READ/WRITTEN 
OPERATION TO BE PERFORMED 

READ OPERATION 

WRITE OPERATION 
MONITOR POINTER 
MONITOR POINTER 
MONITOR STATUS REGISTER 



SECTOR DATA BUFFER 

LOCATE RWTS PARMLIST SUBRTN 

RWTS SUBROUTINE 

PRINT ONE CHAR SUBROUTINE 

PRINT ONE HEX BYTE SUBRTN 

MONITOR HEX DUMP SUBRTN 



IOB TYPE ($01) 

SLOT*16 

DRIVE 

VOLUME 

TRACK 

SECTOR 

ADDRESS OF DCT 

ADDRESS OF BUFFER 

SECTOR SIZE 

COMMAND CODE 

NULL COMMAND 
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0001 
0002 
0004 
000D 
0010 
0020 
0040 
0080 
OOOE 
OOOF 
0010 
0900 



090:0: 



0907:A5 02 
0909:AO 04 
090B:91 00 

090D:A5 03 
090F:C9 10 
0911:90 04 
0913:A9 00 
0915:85 03 
0917:A0 05 
0919:91 00 



091B:A0 08 
091D:A9 00 
091F:91 00 
0921:C8 
0922:A9 08 
0924:91 00 



58 RPLCRD 

59 RPLCWR 

60 RPLCFM 

61 RPLRCD 

62 RPLRWP 

63 RPLRVM 

64 RPLRDE 

65 RPLRRE 
■ 66 RPLTVL 

67 RPLPSL 

68 RPLPDR 
69 



71 



EQU 

EQU 

EQU 

DS 

EQU 

EQU 

EQU 

EQU 

US 

DS 

DS 

DEND 



$01 

$02 

$04 

1 

$10 

$20 

$40 

$80 

1 

1 

] 



READ COMMAND 
WRITE COMMAND 
FORMAT COMMAND 

RETURN CODE 

WRITE PROTECTED 
VOLUME MISMATCH 
DRIVE ERROR 
READ ERROR 

TRUE VOLUME 

PREVIOUS SLOT 

PREVIOUS DRIVE 



0900:20 E3 03 73 ZAP 
0903:84 00 74 
0905:85 01 75 



0926:A5 04 
0928:A0 0C 
092A:91 00 

092C:A9 00 
092E:A0 03 
0930:91 00 

0932: 

0932:20 E3 03 
0935:20 D9 03 
0938:A9 00 
093A:85 48 
093C:90 IB 

093E: 

093E:A9 87 
0940:20 ED FD 
0943:A9 D2 
0945:20 ED FD 
0948:A9 C3 
094A:20 ED FD 
094D:A9 BD 
094F:20 ED FD 
0952:AO 0D 
0954:B1 00 
0956:20 DA FD 



77 
78 
79 

81 
82 
83 

84 

85 

86 SOK 

87 

89 
90 
91 
92 
93 
94 

96 

97 



100 
101 

102 

104 ' 

106 

107 
108 
109 
110 

112 

114 
115 
116 
117 
118 
119 
120 
121 
122 
123 
124 



FILL IN RWTS LIST 



JSR 
STY 

STA 

LDA 

LDY 
STA 

LDA 
CMP 
BCC 

LDA 
STA 
LDY 
STA 



LOCRPL 

PTR 

PTR+1 

TRACK 
#RPLTRK 
(PTR) ,Y 

SECTOR 

#16 

SOK 

#0 

SECTOR 

#RPLSEC 

(PTR) ,Y 



LOCATE RWTS PARMLIST 
AND SAVE POINTER 



GET TRACK TO READ/WRITE 
STORE IN RWTS LIST 



GET SECTOR TO READ/WRITE 
BIGGER THAN 16 SECTORS? 
NO 

YES, PUT IT BACK TO ZERO 
STORE IN RWTS LIST 



1 



0959: 



126 * WHEN FINISHED, DUMP SOME OF SECTOR IN HEX 

800. 8B7 



0959 


A 9 


00 


128 EXIT 


LDA 


#>BUFFER DU 


09 5B 


8 5 


3C 


129 


STA 


AIL 


095D 


A9 


08 


130 


LDA 


#<BUFFER 


09 5F 


8 5 


3D 


131 


STA 


A1L+1 


0961 


A9 


AF 


132 


EDA 


#>BUFFER+$AF 


0963 


B5 


3E 


133 


STA 


A2L 


0965 


A9 


8 


134 


LDA 


#<BUFFER+$AF 


0967 


8b 


3F 


135 


STA 


A2L+1 


0969 


4C 


B3 FD 


136 


JMP 


XAM EX 



EXIT VIA HEX DISPLAY 



*** SUCCESSFUL ASSEMBLY: NO ERRORS 



LDY #RPLBUF 

LDA #>BUFFER STORE BUFFER PTR IN LIST 

STA (PTR) ,Y 

INY 

LDA #<BUFFER 

STA (PTR) ,Y 



LDA OPER 

LDY JRPLCMD 

STA (PTR) ,Y 

LDA #0 

LDY tRPLVOL 

STA (PTR) ,Y 



GET COMMAND CODE 
AND STORE IN LIST 



ANY VOLUME WILL DO 



NOW CALL RWTS TO READ/WRITE THE SECTOR 



JSR LOCRPL 

JSR RWTS 

LDA #0 

STA PREG 

BCC EXIT 



RELOAD POINTER TO PARMS 
CALL RWTS 

FIX P REG SO DOS IS HAPPY 
ALL IS WELL 



ERROR OCCURED PRINT "RC=XX" 



EDA 
JSR 
LDA 
JSR 
LDA 
JSR 
LDA 
JSR 
LDY 
LDA 
JSR 



#BELL 

COUT 

#'R 

COUT 

# ' C 

COUT 

#' = 

COUT 

t RPLRCD 

(PTR) ,Y 

PRBYTE 



BEEP THE SPEAKER 
PRINT THE "RC=" 



GET RWTS RETURN CODE 
PRINT RETURN CODE IN HEX 
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INIT — REFORMAT A SINGLE TRACK 



Occasionally the sectoring information on a diskette can 
become damaged so that one or more sectors can no longer be 
found by DOS. To correct this problem requires that the 
sector address and data fields be re-formatted for the 
entire track thus affected. INIT can be used to selectively 
reformat a single track, thus avoiding a total re-INIT of 
the diskette. Before using INIT, the user should first 
attempt to write on the suspect sector (using ZAP) . If RWTS 
refuses to write to the sector (RC=40) , then INIT must be 
run on the entire track. To avoid losing data, all other 
sectors on the track should be read and copied to another 
diskette prior to reformatting. After INIT is run they can 
be copied back to the repaired diskette and data can be 
written to the previously damaged sector. 

To run INIT, first store the number of the track you wish 
reformatted at location $02, the volume number of the disk 
at location $03 (the volume number should match the volume 
number of the other tracks) , and then begin execution at 
$800. INIT will return to the monitor upon completion. If 
the track can not be formatted for some reason (eg. 
physical damage or problems with the disk drive itself) a 
return code is printed. For example: 



(Get into the monitor from BASIC) 
(Load the INIT program) 



CALL -151 

BLOAD INIT 
...Now insert the disk to be INIT-ed. 

02:11 FE N 800G (Store a 11 (track 17, the catalog 

track) in $02, a volume number of 
$FE (254) in $03, N terminates the 
store command, go to location $800) 

WARNING: DOS 3.3 must be loaded in the machine before 
running INIT and a 48K Apple is assumed. INIT will not work 
with other versions of DOS or other memory sizes. 
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§5- 

6 



■•■a 



0800: 

0800: 
0800: 
0800: 
0800: 
0800: 
0800: 
0800: 
0800: 
0800: 
0800: 
0800: 
0800: 
0800: 
0800: 

0800: 

0000 
0002 
0003 
002D 
003E 
0041 
0044 
0045 
0048 
0087 

0800: 

03E3: 
3D9: 
0578: 
BB00: 
BC00: 
B8DC: 
B944: 
BF0D: 
FDED: 
FDDA: 

0800: 

C080 
C081 
C082 
C083 
C084 
C085 
C086 
C087 
C088 

C089 
C08A 
C08B 

C08C 
C08D 
C08E 
C08F 

0800: 

0000 
0000 
0001 
0002 
0003 
0004 
0005 
0006 
0008 
00OA 



2 ORG $800 

4 *************************************************** #A a***** 

5 * * 

6 * INIT: THIS PROGRAM WILL ALLOW ITS USER TO INITIALIZE A * 

7 * SINGLE TRACK WITH ANY VOLUME NUMBER DESIRED * 

8 * * 

9 * INPUT: $02 = TRACK TO BE INITIALIZED * 

10 * * 

11 * $03 = VOLUME NUMBER * 

12 * * 

13 * ENTRY POINT: $800 * 

14 * * 

15 * PROGRAMMER: PIETER LECHNER 2/19/81 * 

16 * * 
^7 ***************************************** ****************** 



ZPAGE DEFINITIONS 



21 


PTR 


EQU 


$0 


22 


TRACK 


EQU 


$2 


23 


VOLUME 


EQU 


$3 


24 


SECFND 


EQU 


$2D 


2 5 


AA 


EQU 


$3E 


26 


VOL 


EQU 


$41 


27 


TRK 


EQU 


$44 


28 


SYNCNT 


EQU 


$45 


29 


PREG 


EQU 


$48 


30 


BELL 


EQU 


$87 


32 


* 


OTHER ADDR 


34 


LOCRPL 


EQU 


$3E3 


35 


RWTS 


EQU 


$3D9 


36 


RTRYCNT 


EQU 


$578 


37 


NBUF1 


EQU 


$BB00 


38 


NBUF2 


EQU 


$BC00 


39 


READ 16 


EQU 


$B8DC 


40 


RDADR16 


EQU 


$B944 


41 


DSKF2 


EQU 


$BF0D 


42 


COUT 


EQU 


$FDED 


43 


PRBYTE 


EQU 


$FDDA 


45 


* 


DISK 


I/O S 


47 


DRVSM0 


EQU 


$C080 


48 


DRVSM1 


EQU 


$C081 


49 


DRVSM2 


EQU 


$C082 


50 


DRVSM3 


EQU 


$C083 


51 


DRVSM4 


EQU 


$C084 


52 


DRVSM5 


EQU 


$C085 


53 


DRVSM6 


EQU 


$C086 


54 


DRVSM7 


EQU 


$C087 


55 


DRVOFF 


EQU 


$C088 


56 


DRVON 


EQU 


$C089 


57 


DRVSL1 


EQU 


$C08A 


58 


DRVSL2 


EQU 


$C08B 



WORK POINTER 

TRACK TO BE READ/WRITTEN 

VOLUME NUMBER 

SECTOR FOUND BY RDADR16 

ZPAGE CONSTANT FOR TIMING 

VOLUME USED BY WRADR16 

TRACK USED BY WRADR16 

SYNC COUNT USED BY DSKF2 

MONITOR P REGISTER SAVEAREA 

ASCII BELL 



LOCATE RWTS PARMLIST SUBRTN 
RWTS SUBROUTINE 
RETRY COUNT FOR DSKF2 
PRIMARY SECTOR BUFFER 
SECONDARY SECTOR BUFFER 
READ DATA FIELD ROUTINE 
READ ADDRESS FIELD ROUTINE 
FORMAT ONE TRACK ROUTINE 
MONITOR CHARACTER OUTPUT 
MONITOR HEX OUTPUT 



STEP MOTOR POSITIONS 



59 DRVRD EQU $C08C 

60 DRVWR EQU $C08D 

61 DRVRDM EQU $C08E 

62 DRVWRM EQU $C08F 



TURN DRIVE OFF AFTER 6 REVS 
TURN DRIVE ON 
SELECT DRIVE 1 
SELECT DRIVE 2 

READ DATA LATCH 
WRITE DATA LATCH 
SET READ MODE 
SET WRITE MODE 



6 4 



RWTS PARMLIST DEFINITION 



66 




DSECT 


67 


RPLIOB 


DS 1 


68 


RPLSLT 


DS 1 


69 


RPLDRV 


DS 1 


70 


RPLVOL 


DS 1 


7.1 


RPLTRK 


DS 1 


72 


RPLSEC 


DS 1 


73 


RPLDCT 


DS 2 


74 


RPLBUF 


DS 2 


75 


RPLSIZ 


DS 2 



IOB TYPE ($01) 

SLOT*16 

DRIVE 

VOLUME 

TRACK 

SECTOR 

ADDRESS OF DCT 

ADDRESS OF BUFFER 

SECTOR SIZE 



A-13 



oooc 

0000 
0001 
0002 
0004 
OOOD 
0010 
0020 
0040 
0080 
OOOE 
OOOF 
0010 
0800 



76 


RPLCMD 


DS 


1 


COMMAND CODE 


77 


RPLCNL 


EQU 


$00 


NULL COMMAND 


78 


RPLCRD 


EQU 


$01 


READ COMMAND 


79 


RPLCWR 


EQU 


$02 


WRITE COMMAND 


80 


RPLCFM 


EQU 


$04 


FORMAT COMMAND 


81 


RPLRCD 


DS 


1 


RETURN CODE 


82 


RPLRWP 


EQU 


$10 


WRITE PROTECTED 


83 


RPLRVM 


EQU 


$20 


VOLUME MISMATCH 


84 


RPLRDE 


EQU 


$40 


DRIVE ERROR 


85 


RPLRRE 


EQU 


$80 


READ ERROR 


86 


RPLTVL 


DS 


1 


TRUE VOLUME 


87 


RPLPSL 


DS 


1 


PREVIOUS SLOT 


88 


RPLPDR 


DS 


1 


PREVIOUS DRIVE 


89 




DEND 







m si 



USE RWTS TO POSITION THE ARM TO THE DESIRED TRACK 



0800 


20 


E3 


03 


9 3 DUMP 


JSR 


LOCRPL 


LOCATE RWTS PARMLIST 


0803 


84 


00 




94 


STY 


PTR 


AND SAVE POINTER 


0805 


85 


01 




95 


STA 


PTR+1 




0807 


A5 


02 




97 


LDA 


TRACK 


GET TRACK TO READ/WRITE 


0809 


A0 


04 




98 


LDY 


#RPLTRK 


STORE IN RWTS LIST 


080B 


91 


00 




99 


STA 


(PTR) ,Y 




080D 


A9 


00 




101 


LDA 


#RPLCNL 


NULL OPERATION 


080F 


AO 


OC 




102 


LDY 


# RPLCMD 


AND STORE IN LIST 


0811 


91 


00 




103 


STA 


(PTR) ,Y 




0813 


A9 


00 




105 


LDA 


#0 


ANY VOLUME WILL DO 


0815 


A0 


03 




106 


LDY 


#RPLVOL 




0817 


91 


00 




107 


STA 


(PTR) ,Y 




0819 


20 


E3 


03 


108 


JSR 


LOCRPL 


RELOAD POINTER TO PARMS 


081C 


20 


D9 


03 


109 


JSR 


RWTS 


CALL RWTS 


081F 


BD 


89 


CO 


110 


LDA 


DRVON , X 


LEAVE DRIVE ON 


0822 








112 * 


ESTABLISH ENVIRONMENT FOR DSKF2 ROUTINE 


0822 


A5 


02 




114 


LDA 


TRACK 


PASS TRACK TO DSKF2 


0824 


85 


44 




115 


STA 


TRK 




0826 


A5 


03 




116 


LDA 


VOLUME 


AND VOLUME 


0828 


85 


41 




117 


STA 


VOL 




082A 


A9 


AA 




118 


LDA 


♦ $AA 


STORE CONSTANT FOR ZPAGE 


8 2C 


85 


3E 




119 


STA 


AA 


TIMING 


082E 


A9 


28 




120 


LDA 


#$28 


START WITH 40 SYNCS.. 


0830 


85 


45 




121 


STA 


SYNCNT 


BETWEEN SECTORS 


0832 


A0 


56 




122 


LDY' 


#$56 




0834 


A9 


00 




123 


LDA 


#$00 




0836 


99 


FF 


BB 


124 ZNBUF2 


STA 


NBUF2-1 


Y ZERO SECONDARY BUFFER 


0839 


88 






125 


DEY 






083A 


DO 


FA 




126 


BNE 


ZNBUF2 




083C 


99 


00 


BB 


127 ZNBUF1 


STA 


NBUF1,Y 


AND PRIMARY BUFFER 


083F 


88 






128 


DEY 






0840 


DO 


FA 




129 


BNE 


ZNBUF1 




0842 








131 * 


INITIALIZE TRACK 


0842 


20 


0D 


BF 


133 


JSR 


DSKF2 


FORMAT TRACK AND VERIFY 


0845 


A9 


08 




134 


LDA 


♦ $08 


IN CASE OF ERROR. . . 


0847 


B0 


19 




135 


BCS 


HNDERR 


ERROR? 


0849 








137 * 


READ 


SECTOR ZERO TO VERIFY FORMATTING 


0849 


A9 


30 




139 


LDA 


#$30 


NO, DOUBLE CHECK TRACK 


084B 


8D 


78 


05 


140 


STA 


RTRYCNT 


ALLOW 48 RETRIES 


084E 


38 






141 NOGOOD 


SEC 






084F 


CE 


78 


05 


142 


DEC 


RTRYCNT 


COUNT RETRIES 


0852 


F0 


0E 




143 


BEQ 


HNDERR 




0854 


20 


44 


B9 


144 


JSR 


RDADR16 


READ AN ADDRESS FIELD 


0857 


B0 


F5 




145 


BCS 


NOGOOD 


ERROR, TRY AGAIN 


0859 


A5 


2D 




146 


LDA 


SECEND 


IS THIS SECTOR ZERO? 


085B 


DO 


Fl 




147 


BNE 


NOGOOD 


NO, TRY AGAIN 



* Bl 



^ ^1 



085D 


20 


DC 


B8 


148 


JSR 


READ16 


0860 


90 


IF 




149 


BCC 


DONETRK 


0862 


A0 


0D 




150 HNDERR 


LDY 


#RPLRCD 


0864 


91 


00 




151 


STA 


(PTR) ,Y 


0866 








153 * 


ERROR OCCURED 


0866 


A9 


87 




155 


LDA 


#BELL 


0868 


20 


ED 


FD 


156 


JSR 


COUT 


086B 


A9 


D2 




157 


LDA 


#'R 


086D 


20 


ED 


FD 


158 


JSR 


COUT 


0870 


A 9 


C3 




159 


LDA 


#'C 


0872 


20 


ED 


FD 


160 


JSR 


COUT 


0875 


A9 


BD 




161 


LDA 


#' = 


0877 


20 


ED 


FD 


162 


JSR 


COUT 


087A 


A0 


0D 




163 


LDY 


# RPLRCD 


087C 


Bl 


00 




164 


LDA 


(PTR) ,Y 


087E 


20 


DA 


FD 


165 


JSR 


PRBYTE 


0881 








167 * 


WHEN 


DONE, EX 


0881 


BD 


88 


CO 


169 DONETRK 


LDA 


DRVOFF , X 


0884 


A 9 


00 




170 


LDA 


#$00 


0886 


85 


48 




17] 


STA 


PREG 


0888 


60 






172 


RTS 





YES, READ DATA FIELD 
ALL IS WELL, DONE. 
ELSE, PHONEY UP A RC 



BEEP THE SPEAKER 



PRINT THE "RC= 



GET RWTS RETURN CODE 
PRINT RETURN CODE IN HEX 



EXIT TO CALLER 



TURN DRIVE OFF 



CLEAR P REGISTER FOR DOS 
; RETURN TO CALLER 



A-14 



W 3 
■ j'4 

Ht i 5j 



A-15 



FTS - FIND T/S LISTS UTILITY 

From time to time one of your diskettes will develop an I/O 
error smack in the middle of the catalog track. When this 
occurs, any attempt to use the diskette will result in an 
I/O ERROR message from DOS. Generally, when this happens, 
the data stored in the files on the diskette is still 
intact; only the pointers to the files are gone. If the 
data absolutely must be recovered, a knowledgeable Apple 
user can reconstruct the catalog from scratch. Doing this 
involves first finding the T/S Lists for each file, and then 
using ZAP to patch a catalog entry into track 17 for each 
file which was found. FTS is a utility which will scan a 
diskette for T/S Lists. Although it may flag some sectors 
which are not T/S Lists as being such, it will never miss a 
valid T/S List. Therefore, after running FTS the programmer 
must use ZAP to examine each track/sector printed by FTS to 
see if it is really a T/S List. Additionally, FTS will find 
every T/S List image on the diskette, even some which were 
for files which have since been deleted. Since it is 
difficult to determine which files are valid and which are 
old deleted files, it is usually necessary to restore all 
the files and copy them to another diskette, and later 
delete the duplicate or unwanted ones. 

To run FTS, simply load the program and start execution at 
$900 FTS will print the track and sector number of each 
sector it finds which bears a resemblance to a T/S List. 
For example: 



■""'Si 



CALL -151 
BLOAD FTS 



.Now 



insert the disk to be scanned 



(Get into the monitor from BASIC) 
(Load the FTS program) 



900G 



(Run the FTS program on this diskette 



The output might look like this... 

T=12 S=0F 
T=13 S=0F 
T=14 S=0D 
T=14 S=0F 

Here, only four possible files were found. ZAP should now 
oe used to read Lack $12, sector $0F. At +$0C is the track 
and sector of the first sector in the file. This sector can 
be read and examined to try to identify the file and ^s 
type. Usually a BASIC program can be identified, even though 
it is stored in tokenized form, from the text strings 
contained in the PRINT statements. An ASCII conversion 
chart (see page 8 in the APPLE II REFERENCE MANUAL) can be 
used to decode these character strings. Straight T-type 
files will also contain ASCII text, with each ^separated 
from the others with $8D (carriage returns). B - fc yPe i-iJ-es 
are the hardest to identify, unless the address and length 
stored in the first 4 bytes are recognizable If you cannot 
identify the file, assume it is APPLESOFT BASIC. If this 



A-16 



e 

m 
m 
m 
ii'.. 

m 

& 

if 



SI 



51 

3 



assumption turns out to be incorrect, you can always go back 
and ZAP the file type in the CATALOG to try something else. 
Given below is an example ZAP to the CATALOG to create an 
entry for the file whose T/S List is at T=12 S=0F. 

CALL -151 
BLOAD ZAP 

...insert disk to be ZAPped . . . 
800:00 N 801<800.8FEM (Zero sector area of memory) 
80B:12 OF 02 (Track 12, Sector OF, Type-A) 

:C1 A0 A0 A0 A0 A0 A0 (Name is "A") 

:A0 A0 A0 A0 A0 A0 A0 (fill name out with 29 blanks) 
:A0 A0 A0 A0 A0 A0 A0 
:A0 A0 A0 A0 A0 A0 A0 
:A0 A0 
02:11 OF 02 N 900G 



(Write new sector image out as 
first (and only) catalog sector) 

The file should immediately be copied to another diskette 
and then the process repeated for each T/S List found by FTS 
until all of the files have been recovered. As each file is 
recovered, it may be RENAMEd to its previous name. Once all 
the files have been copied to another disk, and successfully 
tested, the damaged disk may be re-INITialized . 



0900: 

0900 
0900 
0900 
0900 
0900 
0900 
0900 
0900 
0900 
0900 
0900 
0900 
0900 



0087: 
008D: 

0900: 

0000 
003C 
003E 
0048 

0900: 

0800 
03E3 
03D9 
FDED 
FDDA 

0900: 

0000 
0000 
0001 
0002 
0003 
0004 
0005 



2 ORG $900 

4 *********************************************************** 

5 * * 

6 * FTS: THIS PROGRAM SCANS THE ENTIRE DISKETTE FOR WHAT * 

7 * APPEAR TO BE TRACK/SECTOR LISTS AND PRINTS THE * 

8 * TRACK AND SECTOR OF EACH ONE IT FINDS. * 

9 * * 

10 * INPUT: NONE * 

11 * * 

12 * ENTRY POINT: $900 * 

13 * * 

14 * PROGRAMMER: DON D WORTH 2/15/81 * 

15 * * 

16 *********************************************************** 



BELL CHARACTER 
CARRIAGE RETURN 



18 


BELL 


EQU 


$87 


19 


RETURN 


EQU 


$8D 


21 


* 


ZPAGE DEFI 


23 


PTR 


EQU 


$0 


24 


AIL 


EQU 


$3C 


25 


A2L 


EQU 


$3E 


26 


PREG 


EQU 


$48 


28 


* 


OTHER ADDR 


30 


BUFFER 


EQU 


$800 


31 


LOCRPL 


EQU 


$3E3 


32 


RWTS 


EQU 


$3D9 


33 


COUT 


EQU 


$FDED 


34 


PRBYTE 


EQU 


SFDDA 


36 


* 


RWTS 


PARML 


38 




DSECT 


39 


RPLIOB 


DS 


1 


40 


RPLSLT 


DS 


1 


4 1 


RPLDRV 


DS 


1 


4 2 


RPLVOL 


DS 


1 


43 


RPLTRK 


DS 


1 


44 


RPLSEC 


DS 


1 



WORK POINTER 
MONITOR POINTER 
MONITOR POINTER 
MONITOR STATUS REGISTER 



SECTOR DATA BUFFER 

LOCATE RWTS PARML1ST SUBRTN 

RWTS SUBROUTINE 

PRINT ONE CHAR SUBROUTINE 

PRINT ONE HEX BYTE SUBRTN 



I OB TYPE 

SLOT* 16 

DRIVE 

VOLUME 

TRACK 

SECTOR 



($01) 



S ■' 3 



A-17 



0006 
0008 
000A 

oooc 

0000 
0001 
0002 
0004 
OOOD 
0010 
0020 
0040 
0080 
OOOE 
OOOP 
0010 
0900 



0900: 



45 


RPLDCT 


DS 


2 


ADDRESS OF DCT 


46 


RPLBUF 


DS 


2 


ADDRESS OF BUFFER 


47 


RPLSIZ 


DS 


2 


SECTOR SIZE 


48 


RPLCMD 


DS 


1 


COMMAND CODE 


49 


RPLCNL 


EQU 


sno 


NULL COMMAND 


50 


RPLCRD 


EQU 


$01 


READ COMMAND 


51 


RPLCWR 


EQU 


$02 


WRITE COMMAND 


52 


RPLCFM 


EQU 


$04 


FORMAT COMMAND 


53 


RPLRCD 


DS 


1 


RETURN CODE 


54 


RPLRWP 


EQU 


$10 


WRITE PROTECTED 


55 


RPLRVM 


EQU 


$20 


VOLUME MISMATCH 


56 


RPLRDE 


EQU 


$40 


DRIVE ERROR 


57 


RPLRRE 


EQU 


$80 


READ ERROR 


58 


RPLTVL 


DS 


1 


TRUE VOLUME 


59 


RPLPSL 


DS 


1 


PREVIOUS SLOT 


60 


RPLPDR 


DS 


1 


PREVIOUS DRIVE 


6] 




DEMD 







0900:20 


E3 03 


6 5 FTS 


JSR 


LOCRPL 


0903:84 


00 


66 


STY 


PTR 


0905:85 


01 


67 


ST A 


PTR+1 


0907:A9 


3 


69 


LDA 


#3 


0909:A0 


04 


70 


LDY 


SRPLTRK 


090B:91 


00 


71 


STA 


(PTR) ,Y 


090D:AO 


08 


73 


LDY 


# RPLBUF 


090F:A9 


00 


74 


LDA 


ff>BUFFER 


0911:91 


00 


75 


STA 


(PTR) ,Y 


0913:C8 




7 6 


INY 




0914:A9 


08 


77 


LDA 


#<BUFFER 


0916:91 


00 


78 


STA 


(PTR) ,Y 


0918:A9 


01 


80 


LDA 


#RPLCRD 


091A:A0 


oc 


81 


LDY 


# RPLCMD 


091C:91 


00 


82 


STA 


(PTR) ,Y 


091E:A9 


00 


84 


LDA 


#0 


0920:A0 


03 


8 5 


LDY 


#RPLVOL 


0922:91 


00 


86 


STA 


(PTR) ,Y 


0924: 




88 * 


NEW 


TRACK, ST 


0924:A0 


5 


90 NEWTRK 


LDY 


#RPLSEC 


0926:A9 


00 


-91 


LDA 


#0 


0928:91 


00 


92 


STA 


(PTR) ,Y 


092A: 




94 * 


NOW 


CALL RWTS 


092A:20 


E3 03 


96 NEWSEC 


JSR 


LOCRPL 


092D:20 


D9 03 


97 


JSR 


RWTS 


0930:A9 


00 


98 


LDA 


#0 


0932:85 


48 


99 


STA 


PREG 


0934:90 


26 


100 


BCC 


SCAN 



START TRACK/SECTOR JUST PAST DOS (TRACK 3) 



LOCATE RWTS PARMLIST 
AND SAVE POINTER 



FIRST NON-DOS TRACK 
STORE IN RWTS LIST 



#>BUFFER STORE BUFFER PTR IN LIST 



GET COMMAND CODE FOR READ 
AND STORE IN LIST 



ANY VOLUME WILL DO 



RELOAD POINTER TO PARMS 
CALL RWTS 



FIX P REG SO DOS IS HAPPY 
ALL IS WELL 



0936: 



] 2 



0936 


20 


B3 


09 


104 


JSR 


PRTTS 


0939 


A9 


87 




!05 


LDA 


#BELL 


093B 


20 


ED 


FD 


106 


JSR 


COUT 


093E 


A9 


D2 




107 


LDA 


#'R 


0940 


20 


ED 


FD 


108 


JSR 


COUT 


0943 


A 9 


C3 




10 9 


LDA 


#'C 


0945 


20 


ED 


FD 


110 


JSR 


COUT 


0948 


A 9 


BD 




111 


LDA 


#' = 


094A 


20 


ED 


FD 


112 


JSR 


COUT 


094D 


A0 


0D 




113 


LDY 


# RPLRCD 


094F 


Bl 


00 




114 


LDA 


(PTR) ,Y 



ERROR OCCURED, PRINT "RC=XX" 



PRINT TRACK/SECTOR 
BEEP THE SPEAKER 



PRINT THE "RC=" 



GET RWTS RETURN CODE 



A-18 



* ; ^ 
fe si 



0951:20 DA FD 
0954:A9 8D 
0956:20 ED FD 
0959:4C 8E 09 

095C: 

095C:A2 00 
095E:BD 00 08 
0961:D0 05 
0963:E8 
0964:D0 F8 
0966:F0 26 

0968:A2 05 
096A:BD 00 08 
096D:D0 IF 
096F:E8 
0970:E0 0C 
0972:90 F6 

0974:BD 00 08 
0977:C9 23 
0979:B0 13 
097B:E8 
097C:BD 00 08 
097F:C9 10 
0981:B0 0B 
0983:E8 
0984:D0 EE 

0986:20 B3 09 
0989:A9 8D 
098B:20 ED FD 

098E: 



115 


JSR 


PRBYTE 


116 


LDA 


#RETURN 


117 


JSR 


COUT 


118 


JMP 


NXTSEC 



122 SCAN 

123 SCLP0 
124 

125 
126 

127 

129 SCAN1 

130 SCLP1 
131 

132 

133 
134 

136 SCLP2 
137 

138 
139 
140 
141 
142 
143 
144 

146 
147 

148 

150 * 



PRINT RETURN CODE IN HEX 

GO ON 

NO ERROR, SEE IF SECTOR LOOKS LIKE A T/S LIST 

LDX #0 

LDA BUFFER, X MAKE SURE ITS NOT ALL ZERO 

BNE SCAN1 

INX 

BNE SCLP0 

BEQ NXTSEC 

LDX #5 

LDA BUFFER, X 

BNE NXTSEC 

INX 

CPX #12 

BCC SCLP1 



IF IT IS, SKIP IT 

START AT OFFSET 5 

HEADER OF T/S MUST BE ZERO 

AT THE T/S PAIRS YET? 
NO, KEEP CHECKING 



LDA BUFFER, X GET TRK 

CMP #35 MUST BE 0-34 

BCS NXTSEC 

INX 

LDA BUFFER, X GET SECTOR 



CMP #16 

BCS NXTSEC 

INX 

BNE SCLP2 

JSR PRTTS 

LDA (RETURN 

JSR COUT 



MUST BE 0-15 



ALL CONDITIONS MET 



BUMP SECTOR NUMBER OR TRACK AND CONTINUE 



098E:A0 


05 




152 


NXTSEC 


LDY 


#RPLSEC 




0990:B1 


00 




153 




LDA 


(PTR) ,Y 


GET LAST SECTOR 


0992:18 






154 




CLC 






0993:69 


01 




155 




ADC 


#1 


BUMP BY ONE 


0995:91 


00 




156 




STA 


(PTR) ,Y 


AND PUT IT BACK IN LIST 


0997:C9 


10 




157 




CMP 


#16 


TOO BIG? 


0999:BO 


03 




158 




BCS 


NXTTRK 




099B:4C 


2A 


09 


159 




JMP 


NEWSEC 


NO, GO READ IT 


099E:A0 


04 




161 


NXTTRK 


LDY 


JRPLTRK 




09A0:B1 


00 




162 




LDA 


(PTR) ,Y 


GET LAST TRACK 


09A2:18 






1.63 




CLC 






09A3:69 


01 




164 




ADC 


#1 


BUMP BY ONE 


09A5:91 


00 




165 




STA 


(PTR) ,Y 


AND PUT IT BACK IN LIST 


09A7:C9 


11 




166 




CMP 


#$11 


CATALOG TRACK? 


09A9:F0 


F3 




167 




BEQ 


NXTTRK 


YES, SKIP OVER THAT ONE 


09AB:C9 


23 




168 




CMP 


#35 


DONE ALL 35 TRACKS? 


09AD:B0 


03 




169 




BCS 


EXIT 


YES, LEAVE 


09AF:4C 


24 


09 


170 




JMP 


NEWTRK 


NO, GO READ FIRST SECTO 


09B2:60 






171 


EXIT 


RTS 






09B3: 






173 


+ 


PRTTS: PRINT 


"T=XX S=XX" 


09B3:A9 


D4 




175 


PRTTS 


LDA 


#'T 


PRINT "T" 


09B5:20 


ED 


FD 


176 




JSR 


COUT 




09B8:A0 


04 




177 




LDY 


#RPLTRK 




09BA:B1 


00 




178 




LDA 


(PTR) ,Y 




09BC:20 


CC 


09 


179 




JSR 


PRTEQ 


PRINT "=XX " 


09BF:A9 


D3 




181 




LDA 


#'S 


PRINT "S" 


09C1:20 


ED 


FD 


182 




JSR 


COUT 




09C4:A0 


05 




183 




LDY 


#RPLSEC 




09C6:B1 


00 




184 




LDA 


(PTR) ,Y 




09C8:20 


CC 


09 


185 




JSR 


PRTEQ 


PRINT "=XX " 


09CB:60 






186 




RTS 







A-19 



09CC:48 


188 


PRTEQ 


PHA 




09CD:A9 BD 


189 




LDA 


#' = 


09CF:20 ED FD 


190 




JSR 


COUT 


09D2:68 


191 




PLA 




09D3:20 DA FD 


192 




JSR 


PRBYTE 


09D6:A9 AO 


193 




LDA 


#' 


09D8:20 ED FD 


194 




JSR 


COUT 


09DB:60 


19 5 




RTS 




*** SUCCESSFUL 


ASSEMBLY: 


NO ERRORS 



■" 3 






Si 



e 4 



0800: 

0800 
0800 
0800 
0800 
0800 
0800 
0800 
0800 
0800 
0800 
0800 
0800 
0800 



COPY - CONVERT FILES 



The COPY program demonstrates the use of the DOS File 
Manager subroutine package from assembly language. COPY 
will read as input a Binary type file, stripping off the 
address and length information, and write the data out as a 
newly created Text type file. The name of the input file is 
assumed to be "INPUT", although this could just as easily 
have been inputted from the keyboard, and the name of the 
output file is "OUTPUT". COPY is a single drive operation, 
using the last drive which was referenced. 

To run COPY, load it and begin execution at $800: 

CALL -151 (Get into the monitor from BASIC) 

BLOAD COPY (Load the COPY program) 

...Now insert the disk containing INPUT... 
800G (Run the COPY program) 

When COPY finishes, it will return to BASIC. If any errors 
occur, the return code passed back from the File Manager 
will be printed. Consult the documentation on the File 
Manager parameter list in Chapter 6 for a list of these 
return codes. 






1 3 



■5 



5 






£ 
P 



A-20 






«j| 008 



0800: 

0000 
0002 
0004 
003C 
003E 

0800: 

1000 
03D0 
03E3 
3DC 
03D6 
FDED 
FDDA 

0800: 

0000 
0000 
0001 
0002 
0003 
0004 
0005 
0006 
0007 
0008 
0009 
000A 
000B 
000C 
0001 

0000 
0001 
0002 
0003 
0004 
0002 

000A 
0002 
0002 
0004 
0005 
0006 
0007 
0000 
0001 
0002 
0004 
0008 



2 ORG $800 

4 *********************************************************** 

5 * * 

6 * COPY:THIS PROGRAM DEMONSTRATES THE USE OF THE DOS FILE * 

7 * MANAGER BY COPYING A BINARY FILE TO A TEXT FILE. * 

8 * * 

9 * INPUT: INPUT FILE NAME IS "INPUT" * 

10 * OUTPUT FILE NAME IS "OUTPUT" * 

11 * * 

12 * ENTRY POINT: $800 * 

13 * * 

14 * PROGRAMMER: DON D WORTH 2/19/81 * 

15 * * 

1C *********************************************************** 



18 BELL 
20 * 

22 PTR 

23 BUFP 

24 EBYTE 

25 AIL 

26 A2L 

28 * 

30 BUFFER 

31 DOSWRM 

32 LOCRPL 

33 LOCFPL 

34 FM 

35 COUT 

36 PRBYTE 

38 * 

40 

41 FMOCOD 

42 FMOCOP 

43 FMOCCL 

44 FMOCRD 

45 FMOCWR 

46 FMOCDE 

47 FMOCCA 

48 FMOCLO 

49 FMOCUN 

50 FMOCRE 

51 FMOCPO 

52 FMOCIN 

53 FMOCVE 

54 FMSBCD 

55 FMSBNO 

56 FMSBON 

57 FMSBRA 

58 FMSBPO 

59 FMSBPR 

60 FMPRMS 

62 * 

63 

64 FMRCLN 

6 5 FMVOL 

66 FMDRV 

67 FMSLT 

68 FMTYPE 

69 FMTYPT 

70 FMTYPI 

71 FMTYPA 

72 FMTYPB 

73 FMNAME 



EQU $87 BELL CHARACTER 
ZPAGE DEFINITIONS 



EQU 
EQU 
EQU 

EQU 
EQU 



SO 

$2 

$4 

S3C 

$3E 



WORK POINTER 

BUFFER POINTER 



MONITOR POINTER 
MONITOR POINTER 



OTHER ADDRESSES 

EQU $1000 DATA BUFFER 

EQU $3D0 DOS WARMSTART ADDRESS 

EQU $3E3 LOCATE RWTS PARMLIST SUBRTN 

EQU $3DC LOCATE FILE MGR PARMLIST SUB 

EQU $3D6 FILE MANAGER ENTRY POINT 

EQU $FDED PRINT ONE CHAR SUBROUTINE 

EQU $FDDA PRINT ONE HEX BYTE SUBRTN 

FILE MANAGER PARMLIST DEFINITION 



DSECT 
DS 

EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
DS 

EQU 

EQU 
EQU 
EQU 
EQU 
DS 



1 

$01 
$02 
SO 3 
S04 
$05 
?06 
$07 
$08 
$09 
$0A 
SOB 

$oc 
1 

$00 
$01 
$0 2 
$03 
$04 



OPEN PARMS 

ORG FMPRMS 

2 

1 
1 
1 
1 

1 
2 
4 
2 



DS 

DS 

DS 

DS 

DS 

EQU 

EQU 

EQU 

EQU 

DS 



OPERATION CODE 

OPEN 

CLOSE 

READ 

WRITE 

DELETE 

CATALOG 

LOCK 

UNLOCK 

RENAME 

POSITION 

INIT 

VERIFY 
SUBCODE 

NO OPERATION 
READ/WRITE ONE BYTE 
READ/WRITE RANGE OF BYTES 
POSITION AND DO ONE BYTE 
POSITION AND DO RANGE 
SPECIFIC PARAMETERS 



RECORD LENGTH 

VOLUME 

DRIVE 

SLOT 

TYPE 

TEXT 

INTEGER 

APPLESOFT 

BINARY 
ADDRESS OF FILE NAME 



A-21 



OOOA 








75 


* 


READ/WRITE PARMS 


0002 








76 




ORG 


FMPRMS 




0002 








77 


■ FMRCNM 


DS 


2 


RECORD NUMBER 


0004 








78 


FMOFFS 


DS 


2 


BYTE OFFSET 


0006 








79 


FMRALN 


DS 


2 


RANGE LENGTH 


0008 








80 


FMRAAD 


DS 


2 


RANGE ADDRESS 


0008 








81 


FMDATA 


EQU 


FMRAAD 


DATA BYTE READ/WRITTEN 


OOOA 








83 


* 


RENAME PARMS 




0002 








84 




ORG 


FMPRMS 




0002 








85 


FMNNAM 


DS 


2 


ADDRESS OF NEW NAME 


■0004 








87 


* 


INIT 


PARMS 




0002 








88 




ORG 


FMPRMS 




0001 








89 


FMPAGE 


EQU 


FMSBCD 


FIRST PAGE OF DOS IMAGE 


0002 








91 


* 


COMMON PARMS 




OOOA 








92 




ORG 


FMPRMS+8 




OOOA 








93 


FMRC 


DS 


1 


RETURN CODE 


0000 








94 


FMRCOK 


EQU 





NO ERRORS 


0002 








95 


FMRCBO 


EQU 


2 


BAD OPCODE 


0003 








96 


FMRCBS 


EQU 


3 


BAD SUBCODE 


0004 








97 


FMRCWP 


EQU 


4 


WRITE PROTECTED 


0005 








98 


FMRCED 


EQU 


5 


END OF DATA 


0006 








99 


FMRCNF 


EQU 


6 


FILE NOT FOUND 


0007 








100 


FMRCBV 


EQU 


7 


BAD VOLUME 


0008 








101 


FMRC 10 


EQU 


8 


I/O ERROR 


0009 








102 


FMRCDF 


EQU 


9 


DISK FULL 


OOOA 








103 


FMRCLK 


EQU 


10 


FILE LOCKED 


OOOB 








104 




DS 


1 


NOT USED 


OOOC 








105 


FMFMWA 


DS 


2 


FILE MANAGER WORKAREA PTR 


OOOE 








106 


FMTSL 


DS 


2 


T/S LIST PTR 


0010 








107 


FMBUFF 


DS 


2 


DATA BUFFER PTR 


0800 








108 




DEND 






0800: 






110 


* 


LOCATE FM PARMLIST 


0800:20 


DC 


03 


112 


COPY 


JSR 


LOCFPL 


FIND PARMLIST 


0803:84 


00 




113 




STY 


PTR 


SET UP POINTER TO IT 


0805:85 


01 




1 1 4 




STA 


PTR+1 




0807: 






1 16 


* 


OPEN 


INPUT FILE 


0807:A0 


08 




118 




LDY 


#FMNAME 


STORE INPUT FILE NAME 


0809:A9 


AC 




119 




LDA 


#>INAME 


PTR IN LIST 


080B:91 


00 




120 




STA 


(PTR) r Y 




080D:C8 






121 




INY 






080E:A9 


09 




L22 




LDA 


#<INAME 




0810:91 


00 




1. 2 3 




STA 


(PTR) ,Y 




0812:A0 


07 




124 




[,DY 


JFMTYPE 


BINARY FILE AS INPUT 


0814:A9 


4 




125 




LDA 


#FMTYPB 




0816:91 


00 




126 




STA 


(PTR) ,Y 




0818:A2 


01 




127 




LDX 


#1 


OLD EILE EXPECTED 


081A:20 


D3 


08 


128 




JSR 


OPEN 


AND OPEN THE FILE 


081D:90 


03 




129 




BCC 


INOP 




081F:4C 


BC 


08 


130 




JMP 


ERROR 


ANY ERROR IS FATAL 


0822:A5 


02 




132 


INOP 


LDA 


BUFP 




0824:8D 


EA 


09 


133 




STA 


IBUFF 


SAVE OPEN FILE BUFFER 


0827:A5 


03 




134 




LDA 


BUFP+1 




0829:8D 


EB 


9 


135 




STA 


IBUFF+1 




082C: 


20 


5ft 


09 


136 




JSR 


REWIND 


POSITION TO START OF FILE 



3 

si 



! 3 

i' 3 

■ ^ 



rt* 


3 


£Ti 


=1 


CI 


3 


■ 


-3 


U.i 


3 



831:A9 CA 
00 



082F: 

082F:A0 08 




c 










33:91 

35:C8 

36:A9 

38:91 

3A:A0 

3C:A9 

3E:91 

40:A2 

42:20 D3 08 

45:90 0B 

47:A0 

49:B1 

4B:C9 



09 
00 
07 
00 
00 
00 



OA 

00 
06 



4D:F0 03 
4F:4C BC 08 



0852:A5 02 
0854:8D E8 09 
0857:A5 03 
0859:8D E9 09 
085C:20 5A 09 

085F: 

085F:A9 04 
0861:A0 06 
0863:91 00 
0865:A9 00 
0867:C8 
0868:91 00 
086A:20 74 09 

086D: 

086D:AD 02 10 
0870:A0 06 
0872:91 00 
0874:AD 03 
0877:C8 
0878:91 
087A:18 
087B:AD 02 
087E:48 
087F:69 00 
0881:85 04 
0883:AD 03 10 
0886:48 
0887:69 10 
0889:85 05 
088B:20 74 



088E: 



10 



00 



138 * 

140 

141 
142 
143 
144 
145 
146 
147 
148 
149 
150 
151 
152 
153 
154 
155 
156 

158 OUTOP 

159 

160 

161 

16 2 

164 * 

166 

167 
168 
169 

J 70 
171 
172 

174 * 

176 

177 
178 
179 
130 
181 



OPEN OUTPUT FILE 



10 



9 



STORE OUTPUT FILE NAME 
PTR IN LIST 



TEXT FILE AS OUTPUT 



NEW FILE IS OK 



FILE NOT FOUND? 

YES, WAS ALLOCATED THEN 



SAVE OPEN OUTPUT FILE BUFFER 



187 
188 
189 
19 
19] 

19 3 



088E 


A0 


00 


19 5 


0890 


9 8 




196 


0891 


91 


04 


197 


0893 


68 




198 


0894 


A0 


07 


19 9 


0896 


91 


00 


200 


0898 


8 8 




201 


0899 


6 8 




202 


089A 


91 


00 


203 


089C 


20 


82 09 


204 



LDY tFMNAME 

LDA #>ONAME 

STA (PTR) ,Y 
INY 

LDA # <ONAME 

STA (PTR) ,Y 

LDY fFMTYPE 

LDA JFMTYPT 

STA (PTR) ,Y 

LDX #0 

JSR OPEN 

BCC OUTOP 

LDY #FMRC 

LDA (PTR) ,Y 

CMP #FMRCNF 

BEQ OUTOP 

JMP ERROR 

LDA BUFP 

STA OBUFF 

LDA BUFP+1 

STA OBUFF+1 

JSR REWIND POSITION TO START OF FILE 

READ ADDRESS/LENGTH FROM BINARY FILE 

LDA #4 READ 4 BYTES FIRST 

LDY # FMRALN 

STA (PTR) ,Y 

LDA #0 

INY 

STA (PTR) ,Y 

JSR READ 

READ ENTIRE BINARY FILE INTO MEMORY AT $1000 

LDA BUFFER+2 COPY DATA LENGTH TO LIST 

LDY # FMRALN 

STA (PTR) ,Y 

LDA BUFFER+3 

INY 

STA (PTR) ,Y 

CLC 

LDA BUFFER+2 COMPUTE ENDING BYTE 

PHA 

ADC #>BUFFER 

STA EBYTE 

LDA BUFFER+3 

PHA 

ADC #<BUFFER 

STA EBYTE+1 

JSR READ READ BLOB INTO MEMORY 

WRITE ENTIRE BLOB OUT INTO TEXT FILE 

LDY #0 

TYA 

STA (EBYTE) ,Y MARK END OF FILE 

PLA 

LDY #FMRALN+1 SET RANGE LENGTH 

STA (PTR) ,Y 

DEY 

PLA 

STA (PTR) ,Y 

JSR WRITE WRITE BLOB FROM MEMORY 



• ^ 



A-22 






A-23 



206 



089F 


AD 


EB 


09 


208 EXIT 


EDA 


OBUFF 


08A2 


85 


2 




209 


STA 


BUFP 


08A4 


AD 


E9 


09 


210 


LDA 


OBUFF+1 


08A7 


8 5 


03 




211 


STA 


8UFP+1 


08A9 


20 


46 


09 


212 


JSR 


CLOSE 


08 AC 


AD 


EA 


09 


213 


EDA 


IBUFF 


08AF 


85 


2 




2! 4 


STA 


BUFP 


08B1 


AD 


EB 


09 


215 


EDA 


IBUFF+1 


08B4 


8 5 


03 




216 


STA 


BUFP+1 


08B6 


20 


4 6 


09 


217 


JSR 


CLOSE 


08B9 


4C 


DO 


03 


218 


J MP 


DOSWRM 



08BC: 



WHEN FINISHED, CLOSE FILES 



CLOSE OUTPUT FILE 



CLOSE INPUT FILE 
BACK TO DOS 



ERROR, PRINT "ERRXX" 



08BC:A0 


0A 




222 


ERROR 


LDY 


#FMRC 


FIND RETURN CODE 


08BE:B1 


00 




22 3 




LDA 


(PTR) ,Y 




08C0:48 






224 




PHA 






08C1:A9 


C5 




22.5 


ERR 


LDA 


#'E 


PRINT "ERR" 


08C3:20 


ED 


FD 


226 




JSR 


COUT 




08C6:A9 


D2 




227 




LDA 


#'R 




08C8:20 


ED 


FD 


228 




JSR 


COUT 




08CB:20 


ED 


FD 


229 




JSR 


COUT 




08CE:68 






2.30 




PEA 






08CF:20 


DA 


FD 


231 




JSR 


PRBYTE 


PRINT HEX CODE 


08D2:00 






232 




BRK 




DIE HORRIBLY 


08D3: 






234 


* 


OPEN 


: COMPLETE 


PARMLIST AND OPEN FILE 


08D3:AD 


D2 


0.3 


2.36 


OPEN 


LDA 


DOSWRM+2 


FIND DOS ENTRY 


08D6:85 


03 




237 




STA 


BUFP+1 




08D8:A0 


00 




238 




LDY 


#0 




08DA:84 


02 




239 




STY 


BUFP 


POINT AT BUFFER CHAIN 


08DC: 






241 


* 


SCAN 


DOS BUFFERS FOR A FREE ONE 


08DC:B1 


02 




24 3 


GBUF0 


EDA 


(BUFP) ,Y 


LOCATE NEXT DOS BUFFER 


08DE:48 






244 




PHA 






08DF:C8 






24 5 




INY 






08E0:B1 


02 




246 




LDA 


(BUFP) ,Y 




08E2:85 


3 




24 / 




STA 


BUFP+1 




08E4:68 






24 8 




PEA 






08E5:85 


02 




249 




STA. 


BUFP 




08E7:D0 


0A 




250 




BNE 


GBUF 


GOT ONE 


08E9:A5 


3 




251 




LDA 


BUFP+1 




08EB:D0 


6 




252 




BNE 


GBUF 


GOT ONE 


08ED:A9 


oc 




254 




EDA 


si 2 


NO FILE BUFFERS RETURN CODE 


08EF:48 






25 5 




PHA 






08F0:4C 


Cl 


08 


256 




JMP 


ERR 


GO PRINT MESSAGE 


08F3:A0 


00 




258 


GBUF 


EDY 


#0 


LOOK AT FILENAME 


08F5:B1 


02 




259 




LDA 


(BUFP) ,Y 




08F7:F0 


04 




26 




BEQ 


GOTBUF 


NONE THERE, FREE BUFFER 


08F9:A0 


24 




261 




LDY 


#36 


IT'S NOT FREE 


08FB:D0 


DF 




262 




BNE 


GBUF0 


GO GET NEXT ONE 


08FD:A9 


0.1 




264 


GOTBUF 


LDA 


#1 




08FF:91 


02 




26 5 




STA 


(BUFP) ,Y 


MARK BUFFER IN USE 



0901: 



26 7 



0901 


A0 


00 


26 9 


EDY 


#FMOCOD 


0903 


A9 


01 


270 


LDA 


#FMOCOP 


0905 


9] 





271 


STA 


(PTR) ,Y 


0907 


A 9 


00 


272 


LDA 


#0 


0909 


A0 


02 


273 


LDY 


#FMRCLN 


090B 


91 


00 


274 


STA 


(PTR) ,Y 


090D 


C8 




275 


INY 




090E 


91 


00 


276 


STA 


(PTR) ,Y 


0910 


A0 


04 


277 


LDY 


IFMVOL 


0912 


91 


00 


278 


STA 


(PTR) ,Y 



FINISH COMPLETING OPEN LIST 



SET OPCODE TO OPEN 



SET RECORD LENGTH TO 



AND VOLUME (ANY VOL) 



A-24 



6 


s 


fe 


M 


£ 


H 


-r 


i4 


- 


4 


fe 


3 


£ 


4 


- 


4 


Ee 


4 


fe" 


3 


£ 


4 


s 


=1 


E 


4 


• 


4 


^ 1 
■J- 4 

1 


H 


H 


3 


H 


3 


H 


3 


■d 


-3 


\ 


3 


ml 


3 


ml 
i 


* 


ml 


3 



0914:20 


E3 03 


280 


JSR 


0917:84 


3C 


281 


STY 


0919:85 


3D 


282 


STA 


091B:A0 


01 


283 


LDY 


091D:B1 


3C 


284 


LDA 


091F:4A 




285 


LSR 


0920:4A 




286 


LSR 


0921:4A 




287 


LSR 


0922:4A 




288 


LSR 


0923:A0 


06 


289 


LDY 


0925:91 


00 


290 


STA 


0927:A0 


02 


291 


LDY 


0929:B1 


3C 


292 


LDA 


092B:A0 


05 


293 


LDY 


092D:91 


00 


294 


STA 


092F: 




296 * 


COM! 


092F:A0 


IE 


298 CALLFM 


LDY 


0931:B1 


02 


299 CFMLP1 


LDA 


0933:48 




300 


PHA 


0934:C8 




301 


INY 


O935:C0 


24 


30 2 


CPY 


0937:90 


F8 


303 


BCC 


0939:A0 


11 


305 


LDY 


093B:68 




306 CFMLP2 


PLA 


093C:91 


00 


307 


STA 


093E:88 




308 


DEY 


093F:C0 


0C 


309 


CPY 


0941:B0 


F8 


310 


BCS 



LOCRPL 
AIL 
A1L+1 
#1 

(AIL) ,Y 
A 
A 
A 
A 
#FMSLT 

(PTR) ,Y 
#2 

(AIL) ,Y 
#FMDRV 

(PTR) ,Y 



FIND RWTS PARMS 



GET SLOT* 16 



SLOT=SLOT/16 



STORE IN LIST 



GET DRIVE 



COMMON INTERFACE TO FILE MANAGER 



#30 
(BUFP) 



#36 
CFMLP1 



GET THREE BUFFER PTRS 



0943:4C D6 03 312 



314 



LDY #FMBUFF+1 



(PTR) ,Y COPY THEM TO FM LIST 



EXIT THRU FILE MANAGER 



CLOSE: CLOSE DOS FILE 



0946:A0 


00 




316 


CLOSE 


LDY 


#FMOCOD 




0948:A9 


02 




31 7 




LDA 


#FMOCCL 




094A:91 


00 




318 




STA 


(PTR) ,Y 




094C:20 


2F 


09 


319 




JSR 


CALLFM 


CLOSE FILE 


094F:90 


0.3 




320 




BCC 


CLOK 




0951:4C 


BC 


8 


321 




JMP 


ERROR 




0954:A0 


00 




322 


CLOK 


LDY 


#0 


FREE BUFFER 


0956:98 






323 




TYA 






0957:91 


02 




324 




STA 


(BUFP) ,Y 




0959:60 






325 




RTS 







095A: 



327 



095A 


A0 


2 




329 


REWIND 


LDY 


#FMRCNM 


09 5C 


A 9 


00 




3 3 




LDA 


#0 


095E 


91 


00 




331 


REWLP 


STA 


(PTR) ,Y 


0960 


C8 






332 




INY 




0961 


CO 


06 




333 




CPY 


#FMOFFS 


0963 


90 


P9 




334 




BCC 


REWLP 


0965 


A0 


00 




335 




LDY 


#FMOCOD 


0967 


A 9 


0A 




336 




I DA 


#FMOCPO 


0969 


91 


00 




337 




STA. 


(PTR) ,Y 


096B 


20 


2F 


09 


338 




JSR 


CALLFM 


096E 


90 


3 




339 




BCC 


REWRTS 


0970 


4C 


BC 


8 


340 




JMP 


ERROR 


0973 


60 






341 


REWRTS 


RTS 





REWIND: POSITION TO START OF FILE 



ZERO RECORD NUMBER AND. 



POSITION OPCODE 



EXIT VIA FILE MANAGER 
CHECK FOR ERRORS 



A-25 



ft 



0974: 

0974:AD EA 09 
0977:85 02 
0979:AD EB 09 
097C:85 03 
097E:A9 03 
0980:D0 OC 

0982: 

0982:AD E8 09 
0985:85 02 
0987:AD E9 09 
098A:85 03 
098C:A9 04 
098E: 

098E: 



098E: 
0990: 
0992: 
0994: 
0996: 
0998: 
099A: 
099C: 
099E: 
099F: 
09A1: 
09A3: 
09A6: 
09A8: 
09AB: 

09AC: 



A0 00 

91 00 

AO 01 

A9 02 

91 00 

AO 08 

A9 00 

91 00 
C8 

A9 10 

91 00 

20 2F 09 

90 03 

4C BC 08 
60 



09AC:C9 CE DO 

09AF:D5 D4 AO 

09B2:A0 AO AO 

09B5:A0 AO AO 

09B8:A0 AO AO 

09BB:A0 AO AO 

09BE:A0 AO AO 

09C1:A0 AO AO 

09C4:A0 AO AO 

09C7:A0 AO AO 

09CA:CF D5 D4 

09CD:D0 D5 D4 

09D0:A0 AO AO 

09D3:A0 AO AO 

09D6:A0 AO AO 

09D9:A0 AO AO 

09DC:A0 AO AO 

09DF:A0 AO AO 

09E2:A0 AO AO 

09E5:A0 AO AO 

09E8: 
09EA: 



343 * 

345 READ 
346 

347 
348 
34 9 
350 

352 * 

354 WRITE 

355 

356 

357 

358 

359 * 

361 * 

363 DOIO 

364 

36 5 

366 
367 
36 8 
369 
370 
371 
372 
373 
374 
375 
376 
377 DOIORT 

379 * 

381 INAME 



READ: READ A RANGE OF BYTES TO $1000 

LDA IBUFF FIND PROPER BUFFER 

STA BUFP 

LDA IBUFF+1 

STA BUFP+1 

LDA #FMOCRD 

BNE DOIO 



READ OPCODE 

GO DO COMMON CODE 



WRITE: WRITE A RANGE OF BYTES FROM $1000 

LDA OBUFF FIND PROPER BUFFER 

STA BUFP 

LDA OBUFF+1 

STA BUFP+1 

LDA #FMOCWR 

BNE DOIO 



WRITE OPCODE 



DOIO: READ/WRITE A RANGE OF BYTES 



LDY 

STA 



JFMOCOD 
(PTR) ,Y 

LDY #FMSBCD 

LDA #FMSBRA 

STA (PTR) ,Y 

LDY #FMRAAD 

LDA #>BUFFER 

STA (PTR) ,Y 
INY 

LDA # BUFFER 

STA (PTR) ,Y 

JSR CALLFM 

BCC DOIORT 

JMP ERROR 
RTS 

DATA 

ASC ' INPUT 



38 2 ONAME 



384 OBUFF 
38 5 IBUFF 



DS 
DS 



SUCCESSFUL ASSEMBLY: NO ERRORS 



SET OPCODE 



DO RANGE OF BYTES 



RANGE ADDRESS=$1000 



CALL FM TO DO I/O OPERATION 



6 Si 
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APPENDIX B 

DISK PROTECTION SCHEMES 



As the quantity and quality of Apple II software has 
jj increased, so has the incidence of illegal duplication of 

copyrighted software. To combat this, software vendors have 
j introduced methods for protecting their software. Since 
-5 most protection schemes involve a modified or custom Di.sk 

Operating System, it seems appropriate to discuss disk 
«l protection in general. 

Typically, a protection scheme's purpose is to stop 
J5 unauthorized duplication of the contents of the diskette, 
although it may also include, or be limited to, preventing 
the listing of the software (if it is in BASIC) . This has 
been attempted in a variety of ways, all of which 
necessitate reading and writing non-standard formats on the 
disk. If the reader is unclear about how a normal diskette 
is formatted, he should refer to Chapter 3 for more 
information . 



Early protection methods were primitive in comparison to 
what is being done now. Just as the methods of protection 
have improved, so have the techniques people have used to 
break them. The cycle seems endless. As new and more 
sophisticated schemes are developed, they are soon broken, 
prompting the software vendor to try to create even more 
sophisticated systems. 

It seems reasonable at this time to say that it is 
impossible to protect a disk in such a way that it can't be 
broken. This is, in large part, due to the fact that the 
diskette must be "bootable"; i.e. that it must contain at 
least one sector (Track 0, Sector 0) which can be read by 
the program in the PROM on the disk controller card. This 
means that it is possible to trace the boot process by 
disassembling the normal sector or sectors that must be on 
the disk. It turns out that it is even possible to protect 
these sectors. Because of a lack of space on the PROM (256 
bytes), the software doesn't fully check either the Address 
Field or the Data Field. But potential protection schemes 
which take advantage of this are limited and must involve 
only certain changes which will be discussed below. 
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Most protected disks use a modified version of Apple's DOS. ^ 
This is a much easier task than writing one's own Disk 
Operating System and will be the primary area covered by 

this discussion. i* 

Although there are a vast array of different protection g. 

schemes, they all consist of having some portion of the disk *— ! 

unreadable by a normal Disk Operating System. The two 

logical areas to alter are the Address Field and the Data « 

Field. Each include a number of bytes which, if changed, 

will cause a sector to be unreadable. We will examine how __ 

that is done in some detail. gj 



The Address Field normally starts with the bytes 
$D5/$AA/$96. If any one of these bytes were changed, DOS 
would not be able to locate that particular Address Field, 
causing an error. While all three bytes can and have been 
changed by various schemes, it is important to remember that 
they must be chosen in such a way as to guarantee their 
uniqueness. Apple's DOS does this by reserving the bytes 
$D5 and $AA; i.e. these bytes are not used in the storage of 
data. The sequence chosen by the would-be disk protector 
can not occur anywhere else on the track, other than in 
another Address Field. Next comes the address information 
itself (volume, track, sector, and checksum). Some common 
techniques include changing the order of the information, 
doubling the sector numbers, or altering the checksum with 
some constant. Any of the above would cause an I/O error in 
a normal DOS. Finally, we have the two closing bytes 
($DE/$AA) , which are similar to the starting bytes, but with 
a difference. Their uniqueness is not critical, since DOS 
will read whatever two bytes follow the information field, 
using them for verification, but not to locate the field 
itself. 

The Data Field is quite similar to the Address Field in that 
its three parts correspond almost identically, as far as 
protection schemes are concerned. The Data Field starts 
with $D5/$AA/$AD, only the third byte being different, and 
all that applies to the Address Field applies here also. 
Switching the third bytes between the two fields is an 
example of a protective measure. The data portion consists 
of 342 bytes of data, followed by a checksum byte. Quite 
often the data is written so that the checksum computation 
will be non-zero, causing an error. The closing bytes are 
identical to those of the Address Field ($DE/$AA) . 

As mentioned earlier, the PROM on the disk controller skips 
certain parts of both types of fields. In particular, 
neither trailing byte ($DE/$AA) is read or verified nor is 
the checksum tested, allowing these bytes to be modified 
even in track sector 0. However, this protection is 
easily defeated by making slight modifications to DOS's RWTS 
routines, rendering it unreliable as a protective measure. 
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m the early days of disk protection, a single alteration 
was all that was needed to stop all but a few from copying 
the disk. Now, with more educated users and powerful 
utilities available, multiple schemes are quite commonly 
used The first means of protection was probably that of 
hidden control characters imbedded in a file name. Now it 
is common to find a disk using multiple non-standard formats 
written even between tracks. 

A state of the art protection scheme consists of two 
elements. First, the data is stored on the diskette in some 
non-standard way in order to make copying very difficult. 
Secondly, some portion of memory is utilized that will be 
altered upon a RESET. (For examp'e, the primary text page 
or certain zero page locations) This is to prevent the 
software from being removed from memory intact. 




THE RACE IS ON BETWEEN 

THE PROTECTORS 
AND THE UNPROTECTORS. 

Recently, several "nibble" or byte copy programs have become 
available. Unlike traditional copy programs which require 
the data to be in a predefined format, these utilities make 
as few assumptions as possible about the data structure. 
Ever since protected disks were first introduced, it has 
been asked, "why can't a track be read into memory and then 
written back out to another diskette in exactly the same 
way?". The problem lies with the self-sync or auto-sync 
bytes. (For a full discussion see Chapter 3) These bytes 
contain extra zero bits that are lost when read into 
memory. In memory it is impossible to determine the 
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difference between a hexadecimal $FF that was data and a hex 
$FF that was a self-sync byte. Two solutions are currently 
being implemented in nibble copy programs. One is to 
analyze the data on a track with the hope that the sync gaps 
can be located by deduction. This has a high probability of 
success if 13 or 16 sectors are present, even if they have 
been modified, but may not be effective in dealing with 
non-standard sectoring where sectors are larger than 256 
bytes. In short, this method is effective but by no means 
foolproof.. The second method is simple but likewise has a 
difficulty. It simply writes every hex $FF found on the 
track as if it were a sync byte. This, however, will expand 
the physical space needed to write the track back out, since 
sync bytes require 25% more room. If enough hex $FF's occur 
in the data, the track will overwrite itself. This can 
happen in general if the drive used to write the data is 
significantly slower than normal. Thus, we are back to 
having to analyze the data and, in effect, make some 
assumptions. It appears that, apart from using some 
hardware device to help find the sync bytes, a software 
program must make some assumptions about how the data is 
structured on the diskette. 



The result of 
been to "force 
initial respon 
defeated the n 
schemes , howev 
which require 
upon the user 
continues, it 
evolve to a po 
to defeat them 



the introduction of nibble copy programs has 

the hand" of the software vendors. The 
se was to develop new protection schemes that 
ibble copy programs. More recent protection 
er , involve hardware and timing dependencies 
current nibble copy programs to rely heavily 
for direction. If the present trend 
is very likely that protection schemes will 
int where automated techniques cannot be used 
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APPENDIX C 

GLOSSARY 



The time required to locate and read or 
write data on a direct access storage 
device, such as a diskette drive. 

The numeric location of a piece of data 
in memory. Usually given as a 
hexadecimal number from $0000 to $FFFF 
(65535 decimal) . A disk address is the 
location of a data sector, expressed in 
terms of its track and sector numbers. 

A sequence of steps which may be 
performed by a program or other process, 
which will produce a given result. 

An alphabetic character (A-Z) or a 
numeric digit (0-9) . The term used to 
refer to the class of all characters and 
digits . 

As opposed to digital. Having a value 
which is continuous, such as a voltage 
or electrical resistance. 

The logical process of determining 
whether two bits are both ones. AND 1 
results in (false) , 1 AND 1 results in 
1 (true) . 

The portion of a disk drive which 
suspends the read/write head over the 
disk's surface. The arm can be moved 
radially to allow access to different 
tracks. 

American Standard Code for Information 
Interchange. A hexadecimal to character 
conversion code assignment, such that 
the 256 possible values of a single byte 
may each represent a alphabetic, 
numeric, special, or control character. 
ASCII is used when interfacing to 
peripherals, such as keyboards, 
printers, or video text displays. 
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ASSEMBLY LANGUAGE 



BACKUP 



BASE 



BINARY 



BIT 



BIT CELL 



BIT SLIP MARKS 



BOOT /BOOTSTRAP 



BRK 



BUFFER 



BUG 
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Also known as MACHINE LANGUAGE. The 
native programming language of the 
individual computer. Assembly language 
is oriented to the machine, and is not 
humanized, as is BASIC, PASCAL, or 
FORTRAN. An assembler is used to 
convert assembly language statements to 
an executable program. 

The process of making a copy of a 
program or data against the possibility 
of its accidental loss or destruction. 

The number system in use. Decimal is 
base 10, since each digit represents a 
power of 10 (1,10,100,...). Hexadecimal 
is base 16 (1,16,256,...). Binary is 
base 2 (1 , 2 ,4 ,8 , . . . ) . 

A number system based upon powers of 2. 
Only the digits and 1 are used. 101 
in binary, for example, is 1 units 
digit, twos, and 1 fours, or 5 in 
decimal . 

A single binary digit (a 1 or a 0) . A 
bit is the smallest unit of storage or 
information in a computer. 

The space on a diskette, between two 
clock pulses, which can hold the value 
of a single binary or 1 (bit) . 

The epilogue of a disk field. Used to 

double check that the disk head is still 

in read sync and the sector has not been 
damaged . 

The process of loading a very large 
program into memory by loading 
successively larger pieces, each of 
which loads its successor. The program 
loads itself by "pulling itself up by 
its bootstraps". 

BREAK. An assembly langauge instruction 
which can be used to force an interrupt 
and immediate suspension of execution of 
a program. 

An area of memory used to temporarily 
hold data as it is being transferred to 
or from a peripheral, such as a disk 
drive. 

A programming error. Faulty operation 
of a program. 
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BYTE 



CARRIAGE RETURN 



fe 

E 



tJ carry flag 
^a catalog 

«J CHAIN 

HI 

CHECKSUM/CRC 



BL. I ^ CLOBBERED 

■4 * 

CODE 
COLDSTART 

* 3 

*I CONTIGUOUS 

ml 3 
m. 3 



CONTROL BLOCK 
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The smallest unit of addressable memory 
in a computer. A byte usually consists 
of 8 bits and can contain a decimal 
number ranging from to 255 or a single 
alphanumeric character. 

A control character which instructs the 
printer to end one line and begin 
another. When printing a carriage 
return is usually followed by a line 
feed . 

A 6502 processor flag which indicates 
that a previous addition resulted in a 
carry. Also used as an error indicator 
by many system programs. 

A directory of the files on a diskette. 
See DIRECTORY. 

A linked list of data elements. Data is 
chained if its elements need not be 
contiguous in storage and each element 
can be found from its predecessor via an 
address pointer. 

A method for verifying that data has not 
been damaged. When data is written, the 
sum of all its constituent bytes is 
stored with it. If, when the data is 
later read, its sum no longer matches 
the checksum, it has been damaged. 

Damaged or destroyed. A clobbered 
sector is one which has been overwritten 
such that it is unrecoverable. 

Executable instructions to the computer, 
usually in machine language. 

A restart of a program which 
reinitializes all of its parameters, 
usually erasing any work which was in 
progress at the time of the restart. A 
DOS coldstart erases the BASIC program 
in memory. 

Physically next to. Two bytes are 
contiguous if they are adjoining each 
other in memory or on the disk. 

A collection of data which is used by 
the operating system to manage 
resources. Examples of a control block 
used by DOS are the file buffers. 
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CONTROL CHARACTER 



CONTROLLER CARD 



CSWL 



CYCLE 



DATA 



DATA SECTOR BUFFER 



DATA TYPE 



DCT 



DECIMAL 



DEFERRED COMMANDS 



A special ASCII code which is used to 
perform a unique function on a jj,,, 

peripheral, but does not generate a 
printable character. Carriage return, 
line feed, form feed, and bell are all i"" 
control characters. 

A hardware circuit board which is 
plugged into an APPLE connector which 
allows communication with a peripheral jifi 
device, such as a disk or printer. A 
controller card usually contains a small 
driver program in ROM. ■»'' 

A vector in zero-page through which r- 
output data is passed for display on the E' 
CRT or for printing. 

The smallest unit of time within the 
central processor of the computer. Each 
machine language instruction requires {■' 
two or more cycles to complete. One 
cycle (on the APPLE) is one micro-second c 
or one millionth of a second. 

Units of information. 



On the APPLE, a 256 byte buffer used by 
DOS to hold the image of any given 
sector on the diskette. As information 
is read from the file, data is extracted 
from the data sector buffer until it is 
exhausted, at which time it is refilled 
with the next sector image. 

The type of information stored in a 
byte. A byte might contain a printable 
ASCII character, binary numeric data, or 
a machine language instruction. 

Device Characteristics Table. Used as an 
input parameter table to Read/Write 
Track/Sector (RWTS) to describe the 
hardware characteristics of the diskette 
drive . 

A number system based upon powers of 
10. Digits range from to 9 . 

DOS commands which may (or must) be 
invoked from within an executing BASIC 
program. OPEN, READ, WRITE, and CLOSE 
are all examples of deferred commands. 



SI 
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DIGITAL As opposed to analog. Discrete values as 

opposed to continuous ones. Only 
digital values may be stored in a 
computer. Analog measurements from the 
real world, such as a voltage or the 
level of light outside, must be 
converted into a numerical value which, 
of necessity, must be "rounded off" to a 
discrete value. 



DIRECT ACCESS 
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DISPLA 
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3 






3 








DRIVER 
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DUMP 
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ENCODE 
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Peripheral storage allowing rapid access 
of any piece of data, regardless of its 
placement on the. medium. Magnetic tape 
is generally not considered direct 
access, since the entire tape must be 
read to locate the last byte. A 
diskette is direct access, since the arm 
may be rapidly moved to any track and 
sector . 



DIRECTORY A catalog of all files stored on a 

diskette. The directory must contain 
each file's name and its location on the 
disk as well as other information 
regarding the type of data stored 
there . 

DISK INITIALIZATION The process which places track 

formatting information, including 
sectors and gaps, on a blank diskette. 
During disk initialization, DOS also 
places a VTOC and directory on the newly 
formatted disk, as well as saving the 
HELLO program. 

3NT The distance from the beginning of a 
block of data to a particular byte or 
field. Displacements are usually given 
beginning with 0, for the first byte, 1 
for the second, etc. Also known as an 
offset. 

A program which provides an input stream 
to another program or an output device. 
A printer driver accepts input from a 
user program in the form of lines to be 
printed, and sends them to the printer. 

An unformatted or partially formatted 
listing of the contents of memory or a 
diskette in hexadecimal. Used for 
diagnostic purposes. 

To translate data from one form to 
another for any of a number of reasons. 
In DOS 3.3, Data is encoded from 8 bit 
bytes to 6 bit bytes for storage on a 
DISK II. 
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ENTRY POINT (EPA) 



EOF 



EPILOGUE 



EXCLUSIVE OR 



FIELD 



FILE 



FILE BUFFERS 



FILE DESCRIPTOR 



FILE MANAGER 



FILE TYPE 



FIRMWARE 
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The entry point address is the location 
within a program where execution is to 
start. This is not necessarily the same 
as the load point (or lowest memory 
address in the program) . 

End Of File. This mark signals the end 
of a data file. $00 for APPLE DOS text 
files . 

The last three bytes of a field on a 
track. These unique bytes are used to 
insure the integrity of the data which 
preceeds them. 

A logical operation which compares two 
bits to determine if they are 
different. 1 EOR results in 1. 1 EOR 
1 results in 0. 

A group of contiguous bytes forming a 
single piece of data, such as a person's 
name, his age, or his social security 
number. In disk formatting, a group of 
data bytes surrounded by gaps. 

A named collection of data on a diskette 
or other mass storage medium. Files can 
contain data or programs. 

In APPLE DOS, a collection of buffers 
used to manage one open file. Included 
are a data sector buffer, a Track/Sector 
List sector buffer, a file manager 
workarea buffer, the name of the file, 
and pointers. The DOS command, MAXFILES 
3, causes 3 of these file buffers to be 
allocated . 

A single entry in a diskette directory 
which describes one file. Included are 
the name of the file, its data type, its 
length, and its location on the 
diskette . 

That portion of DOS which manages 
files. The file manager handles such 
general operations as OPEN, CLOSE, READ, 
WRITE, POSITION, RENAME, DELETE, etc. 

The type of data held by a file. Valid 
DOS file types are Binary, Applesoft, 
Integer-BASIC, Text, Relocatable, S, A, 
and B. 

A middle ground between hardware and 
software. Usually used to describe 
micro-code or programs which have been 
stored in read-only memory. 
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HARDWARE 



fc: 
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fc 

E 

Ei 

Wi 

Ej 
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HEAD 



HEXADECIMAL/HEX 



HIGH MEMORY 



HIMEM 






IMMEDIATE COMMAND 



INDEX 



5| INSTRUCTION 



INTEGER 






The spaces between fields of data on a 
diskette. Gaps on an APPLE diskette 
contain self -sync bytes. 

An unrecoverable Input/Output error. 
The data stored in the disk sector can 
never be successfully read again. 

Physical computer equipment, as opposed 
to programs which run on the equipment. 
A disk drive is an example of a hardware 
component. 

The read/write head on a diskette 
drive. A magnetic pickup, similar in 
nature to the head on a stereo tapedeck , 
which rests on the spinning surface of 
the diskette. 

A numeric system based on powers of 16. 
Valid hex digits range from to 9 and A 
to F, where A is 10, B is 11, ... , and 
F is 15. B30 is 11 256's, 3 16's, and 
l's, or 2864 in decimal. Two 
hexadecimal digits can be used to 
represent the contents of one byte. 
Hexadecimal is used with computers 
because it easily converts with binary. 

Those memory locations which have high 
address values. $FFFF is the highest 
memory location. Also called the "top" 
of memory. 

APPLE'S zero-page address which 
identifies the first byte past the 
available memory which can be used to 
store BASIC programs and their 
variables . 

A DOS command which may be entered at 
any time, especially when DOS is waiting 
for a command from the keyboard. 
Deferred commands are the opposite of 
immed i a te command s . 

A displacement into a table or block of 
storage. 

A single step to be performed in an 
assembly language or machine language 
program. Instructions perform such 
operations as addition, subtraction, 
store, or load. 

As opposed to floating point. A "whole" 
number with no fraction associated with 
it. 
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INTERCEPT 



INTERLEAVE 



INTERRUPT 



IOB 



I/O ERROR 



JMP 



JSR 



KSWL 



LABEL 



LATCH 



A program which logically places itself 
in the execution path of another 
program, or pair of programs. A video 
intercept is used to re-direct program 
output from the screen to a printer, for 
example . 

The practice of selecting the order of 
sectors on a diskette track to minimize 
access time due to rotational delay. 
Also called "skewing" or interlacing. 

A hardware signal which causes the 
computer to halt execution of a program 
and enter a special handler routine. 
Interrupts are used to service real-time 
clock time-outs, BRK instructions, and 
RESET . 

Input/Output Block. A collection of 
parameter data, passed to Read/Write 
Track/Sector, describing the operation 
to be performed. 

Input/Output Error. An error which 
occurs during transmission of data to or 
from a peripheral device, such as a disk 
or cassette tape. 

A 6502 assembly langauge instruction 
which causes the computer to begin 
executing instructions at a different 
location in memory. Similar to a GOTO 
statement in BASIC. 

A 6502 assembly langauge instruction 
which causes the computer to "call" a 
subroutine. Similar to a GOSUB statement 
in BASIC. 

A unit of measurement, usually applied 
to bytes. 1 K bytes is equivalent to 
1024 bytes. 

A vector in zero-page through which 
input data is passed from the 
keyboard or a remote terminal. 

A name associated with a location in a 
program or in memory. Labels are used in 
assembly langauge much like statement 
numbers are used in BASIC. 

A component into which the Input/Output 
hardware can store a byte value,, which 
will hold that value until the central 
processor has time to read it (or vice 
versa) . 






LINK 



LIST 



LOAD POINT (LP) 



LOGICAL 



LOOP 



LOW MEMORY 



LOMEM 



LSB/LO ORDER 
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MASTER DISK 



MICROSECOND 



MONITOR 
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An address pointer in an element of a 
linked chain of data or buffers; 

A one dimensional sequential array of 
data items. 

The lowest address of a loaded assembly 
language program — the first byte 
loaded. Not necessarily the same as the 
entry point address (EPA) . 

A form of arithmetic which operate-s with 
binary "truth" or "false", 1 or 0. AND, 
OR, NAND, NOR, and EXCLUSIVE OR are all 
logical operations. 

A programming construction in which a 
group of instructions or statements are 
repeatedly executed. 

The memory locations with the lowest 
addresses. $0000 is the lowest memory 
location. Also called the "bottom" of 
memory. 

APPLE'S zero-page address which 
identifies the first byte of the 
available memory which can be used to 
store BASIC programs and their 
variables . 

Least Significant Bit or Least 
Significant Byte. The l's bit in a byte 
or the second pair of hexadecimal digits 
forming an address.. In the address 
$8030, $30 is the LO order part of the 
address . 

A DOS diskette which will boot in an 
APPLE II of any size memory and take 
full advantage of it. 

A millionth of a second. Equivalent to 
one cycle of the APPLE II central 
processor. Also written as "Usee". 

A machine language program which always 
resides in the computer and which is the 
first to receive control when the 
machine is powered up. The APPLE 
monitor resides in ROM and allows 
examination and modification of memory 
at a byte level. 
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MSB/HI ORDER 



NULL 



NIBBLE/NYBBLE 



OBJECT CODE 



OBJECT MODULE 



OFFSET 



OPCODE 



OPERATING SYSTEM 



OR 



OVERHEAD 



PAGE 
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Most Significant Bit or Most Significant 
Byte. The 128' s bit of a byte (the 
left-most) or the first pair of 
hexadecimal digits in an address. In 
the byte value $83, the MSB is on (is a 
1). 

Empty, having no length or value. A 
null string is one which contains no 
characters. The null control character 

($00) produces no effect on a printer 

(also called an idle) . 

A portion of a byte, usually 4 bits and 
represented by a single hexadecimal 
digit. $FE contains two nibbles, $F and 

$E. 

A machine language program in binary 
form, ready to execute. Object code is 
the output of an assembler. 

A complete machine language program in 
object code form, stored as a file on a 
diskette . 

The distance from the beginning of a 
block of data to a particular byte or 
field. Offsets are usually given 
beginning with 0, for the first byte, 1 
for the second, etc. Also known as a 
displacement. 

Operation Code. The three letter 
mnemonic representing a single assembly 
language instruction. JMP is the opcode 
for the jump instruction. 

A machine language program which manages 
the memory and peripherals 
automatically, simplifying the job of 
the applications programmer. 

The logical operation comparing two bits 
to determine if either of them are 1. 1 
OR 1 results in 1 (true) , 1 OR results 
in 1, OR results in (false) . 

The space required by the system, either 
in memory or on the disk, to manage 
either. The disk directory and VTOC are 
part of a diskette's overhead. 

256 bytes of memory which share a common 
high order address byte. Zero page is 
the first 256 bytes of memory ($0000 
through $0OFF) . 
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Opposite of serial. A communication 
mode which sends all of the bits in a 
byte at once, each over a separate line 
or wire. 

An area of storage set aside for 
communication between a calling program 
and a subroutine. The parameter list 
contains input and output variables 
which will be used by the subroutine. 

A scheme, similar to checksums but on a 
bit level rather than a byte level, 
which allows detection of errors in a 
single data byte. An extra parity bit 
is attached to each byte which is a sum 
of the bits in the byte. Parity is used 
in expensive memory to detect or correct 
single bit failures, and when sending 
data over communications lines to detect 
noise errors. 

The process of interpreting character 
string data, such as a command with 
keywords . 

A small change to the object code of an 
assembly language program. Also called 
a "zap". 

A device which is external to the 

computer itself, such as a disk drive or 

a printer. Also called an Input/Output 
device . 

A collection of data corresponding to 
the smallest unit of storage on a 
peripheral device. For disks, a 
physical record is a sector. 

The address or memory location of a 
block of data or a single data item. 
The address "points" to the data. 

The three bytes at the beginning of a 
disk field which uniquely identify it 
from any other data on the track. 

Programmable Read Only Memory. PROMs are 
usually used on controller cards 
associated with peripherals to hold the 
driver program which interfaces the 
device to applications programs. 

An output string which lets the user 
know that input is expected. A "*" is 
the prompt character for the APPLE 
monitor . 
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PROTECTED DISK 



PSEUDO-OPCODE 



RANDOM ACCESS 



RAM 



RECAL 



RECORD 



REGISTER 



RELEASE 



RELOCATABLE 



A diskette whose format or content has 
been modified to prevent its being 
copied. Most retail software today is 
distributed on protected disks to 
prevent theft. 






RETURN CODE 



A special assembly language opcode which I* 
does not translate into a machine 
instruction. A pseudo-opcode instructs 
the assembler to perform some function, 
such as skipping a page in an assembly 
listing or reserving data space in the 
output object code. 



Direct access. The capability to 
rapidly access any single piece of data 
on a storage medium without having to 
sequentially read all of its 
predecessors. 

Random Access Memory. Computer memory 
which will allow storage and retrieval 
of values by address. 

Recalibrate the disk arm so that the 
read/write head is positioned over track 
zero. This is done by pulling the arm 
as far as it will go to the outside of 
the diskette until it hits a stop, 
producing a "clacking" sound. 

A collection of associated data items or 
fields. One or more records are usually 
associated with a file. Each record 
might correspond to an employee, for 
example. 

A named temporary storage location in 
the central processor itself. The 6502 
has 5 registers; the A, X, Y, S, and P 
registers. Registers are used by an 
assembly language program to access 
memory and perform arithmetic. 

A version of a distributed piece of 
software. There have been several 
releases of DOS. 

The attribute of an object module file 
which contains a machine language 
program and the information necessary to 
make it run at any memory location. 
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SECTOR ADDRESS 



SECTOR DATA 



SEEK 



SELF-SYNC 



SEQUENTIAL ACCESS 
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A numeric value returned from a . 
subroutine, indicating the success or 
failure of the operation attempted. A 
return code of zero usually means there 
were no errors. Any other value 
indicates the nature of the error, as 
defined by the design of the 
subroutine. 

Read Only Memory. Memory which has a 
permanent value. The APPLE monitor and 
BASIC interpreters are stored in ROM. 

Read/Write Track/Sector. A collection 
of subroutines which allow access to the 
diskette at a track and sector level. 
RWTS is part of DOS and may be called by 
external assembly language programs. 

The process of scanning a track for a 
given sector . 

The smallest updatable unit of data on a 
disk track. One sector on an APPLE DISK 
II contains 256 data bytes. 

A disk field which identifies the sector 
data field which follows in terms of its 
volume, track, and sector number. 

A disk field which contains the actual 
sector data in nibbilized form. 

The process, of moving the disk arm to a 
given track. 

Also called "auto-sync" bytes. Special 
disk bytes which contain more than 8 
bits, allowing synchronization of the 
hardware to byte boundaries when 
reading . 

A mode of data retreival where each byte 
of data is read in the order in which it 
was written to the disk. 

As opposed to parallel. A communication 
mode which sends data bits one at a time 
over a single line or wire. 

A logical operation which moves the bits 
of a byte either left or right one 
position, moving a into the bit at the 
other end. 
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SLAVE DISK 

SOFT ERROR 
SOFTWARE 
SOURCE CODE 



SKEWING 



STATE MACHINE 



STROBE 



SUBROUTINE 



TABLE 



TOGGLE 



A diskette with a copy of DOS which is 
not relocatable. The DOS image will 
always be loaded into the same memory 
location, regadless of the size of the 
machine . 

A recoverable I/O error. A worn diskette 
might produce soft errors occasionally. 

Computer programs and data which can be 
loaded into RAM memory and executed. 

A program in a form which is 
understandable to humans; in character 
form as opposed to internal binary 
machine format. Source assembly code 
must be processed by an assembler to 
translate it into machine or "object" 
code . 

The process of interleaving sectors. 
See INTERLEAVE. 

A process (in software or hardware) 
which defines a unique target state, 
given an input state and certain 
conditions. A state machine approach is 
used in DOS to keep track of its video 
intercepts and by the hardware on the 
disk controller card to process disk 
data. 

The act of triggering an I/O function by 
momentarily referencing a special I/O 
address. Strobing $C030 produces a 
click on the speaker. Also called 
"toggling" . 

A program whose function is required 
repeatedly during execution, and 
therefore is called by a main program in 
several places. 

A collection of data entries, having 
similar format, residing in memory. 
Each entry might contain the name of a 
program and its address, for example. A 
"lookup" can be performed on such a 
table to locate any given program by 
name. 



The act of triggering an I/O function by Kj 

momentarily referencing a special I/O 

address. Toggling $C030 produces a 

click on the speaker. Also called C 

"strobe". 
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A method where human recognizable words 
may be coded to single binary byte 
values for memory compression and faster 
processing. BASIC statements are 
tokenized, where hex codes are assigned 
to words like IF, PRINT, and END. 

One complete circular path of magnetic 
storage on a diskette. There are 35 
concentric tracks on an APPLE diskette. 

A table of single byte codes which are 
to replace input codes on a one-for-one 
basis. A translate table is used to 
convert from 6 bit codes to disk codes. 

Track/Sector List. A sector which 
describes the location of a file by 
listing the track and sector number for 
each of its data sectors in the order 
that they are to be read or written. 

Transistor to Transistor Logic. A 
standard for the interconnection of 
integrated circuits which also defines 
the voltages which represent O's and 
l's. 

A program which is used to maintain, or 
assist in the development of, other 
programs or disk files. 

A collection of pointers or JMP 
instructions at a fixed location in 
memory which allow access to a 
relocatable program or data. 

An identification for a diskette, disk 
platter, or cassette, containing one or 
more files. 

Volume Table Of Contents. Based upon the 
IBM OS/VS VTOC. On the APPLE, a sector 
mapping the free sectors on the diskette 
and giving the location of the 
directory. 

A restart of a program which retains, as 
much as is possible, the work which was 
in progress at the time. A DOS 
warmstart retains the BASIC program in 
memory. 

A diskette whose write protect notch is 
covered, preventing the disk drive from 
writing on it. 
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ZAP 



ZERO PAGE 



From the IBM utility program, SUPERZAP. 
A program which allows updates to a disk 
at a byte level, using hexadecimal. 

The first 256 bytes of memory in a 6502 
based machine. Zero page locations have 
special significance to the central 
processor, making their management and 
assignment critical. 
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S in Applesoft 5-5 

A type file 2-2, 4-6, 4-12, 6-12 

Address Field 3-7, 3-10 to 3-14, 3-17, 8-36, 8-37, 8-40, B-l, B-2 

allocate sector/track 4-1 to 4-4, 4-10, 4-18, 8-25, 8-29 to 8-33 

APPEND command 2-1, 8-4, 8-10, 8-19, 8-34 

Applesoft entry point vector 8-5 

file 4-6, 4-7, 4-12, 4-14, 6-10 
autosync bytes - see self-sync bytes 
autostart ROM 2-1, 2-2, 5-5 

B type file 2-2, 4-6, 4-12, 6-10, A- 2 
BASIC coldstart 8-4, 8-5 

commands 8-18, 8-19 

entry point vector table 8-4 

error handler 8-4 

relocate 8-4 

warmstart 8-5 
BINARY file 4-6, 4-7, 4-10, 4-12, 4-13, 6-10 
bit cell 3-3, 3-7, C-2 

BLOAD command 4-12, 8-4, 8-11, 8-19, 8-20 
boot, bootstrap loading 2-3, 3-22, 4-2, 5-1, 5-4 to 5-7, 7-2, 

8-1 to 8-3, 8-34, B-l, C-2 
bootstrap loader 2-3, 5-4 
BRUN command 4-12, 8-4, 8-19 
BSAVE command 2-3, 4-2, 4-12, 8-4, 8-11, 8-19, 8-34 

catalog 3-2, 4-2, 4-4 to 4-7, 4-10, 4-17, 4-18, 6-7, 6-15, 

8-22, 8-26, 8-30, C-3 
CATALOG command .5-2, 6-8, 6-11, 6-13, 7-3, 8-4, 8-14, 8-25, 8-32 
CHAIN command 8-4, 8-13, 8-19 
Checksum 3-7, 3-12 to 3-14, 3-17, 4-17, 8-2, 8-35, 8-36, 8-42, 

B-2, C-3 
clobbered diskettes 1-1, 4-16 to 4-18 
CLOSE command 5-2, 6-8, 6-10, 8-4, 8-11, 8-19, 8-23 
close files 6-8, 6-10, 8-10 to 8-12 

coldstart 5-5, 5-7, 7-3, 8-4, 8-5, 8-14, 8-20, C-3 
command handler table 8-9 
controller card 8-1, C-3 
COPY 2-2, 2-3, 4-18 
CP/M 3-22 

CSWL 8-6, 8-7, 8-13, 8-15, 8-18, 8-20, 8-42, C-4 
cursor 8-5, 8-42 
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B-l, B-2 



8-19, 8-25 



8-38, 
C-l, 



8-42, C-4 
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damaged diskettes 4-16 to 4-18 

data bit 3-3, 3-7 

data bytes 3-7, 3-14, 3-15, 3-21, 6-4 

Data Field 3-7, 3-10 to 3-13, 3-17, 8-41, 

Data Field encoding 3-13 

data latch 3-4, 3-7, 3-8, 6-2, 6-3, C-8 

DCT - see Device Characteristics Table 

decimal convert routine 8-9 

decode 3-7, 3-10, 3-17 

DELETE command 4-18, 5-2, 6-8, 6-11, 8-4, 

deleted file 4-6 

descriptive entry 4-6, 4-8, 4-17, 4-18 

Device Characteristics Table 8-35, 8-37, 

disk arm 3-2, 4-2, 5-7, 8-1, 8-36 to 8-38, 

disk arm phases 3-2, 6-2, 6-3, 6-5, 8-35 

disk bytes 3-13 to 3-16, 3-20 

disk protection - see protected disks 

DOS 3.2.1 and earlier 1-2, 2-1 to 2-3, 3-2, 3-8, 3-14, 3-22, 

DOS 3.3 1-2, 2-1 to 2-3, 3-2, 3-14, 3-20, 3-22, 7-2, A-2 

DOS toolkit - see toolkit 

DOS command parse routine 8-7 

exit routine 8-7 

restore register routine 8-7 
DUMP - see utility programs 

encode 8-38, C-5 

encode data 3-13 

encoding technique 3-13 to 3-15, 3-20 

epilogue 3-7, 3-12, 3-13, C-2, C-6 

error message text table 8-20 

ERROR, DISK FULL 4-18, 6-8, 8-30 to 8-32, 8-41 

END OF DATA 8-15, 8-16, 8-24, 8-32 

FILE LOCKED 8-32 

FILE NOT FOUND 8-22, 8-32 

FILE TYPE MISMATCH 8-12, 8-17 

LANGUAGE NOT AVAILABLE 8-14, 8-22, 8-32 

PROGRAM TOO LARGE 8-12, 8-13 

RANGE 8-8, 8-32 

SYNTAX 8-8, 8-11, 8-16 

WRITE PROTECTED 8-32 
EXEC command 8-4 to 8-6, 8-11, 8-17, 8-19 

FID 2-3, 4-18, 6-7 

file buffer 5-2, 5-7, 6-8, 6-13, 

8-15 to 8-17, 8-20, 8-26, 
file manager 5-2, 5-5, 5-7, 6-7, 

8-10, 8-12, 8-14 to 8-16, 
file manager workarea 6-8, 6-10 

8-25 to 8-29, 8-31, 8-33, 8-41 
FORMAT command 6-5, 6-7, 8-19, 8-35 
FP command 8-4, 8-19 
free sectors 2-3, 4-3, 4-4, 4-18, 8-30 

gaps 3-7, 3-10, 3-11, C-7 
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hardware addresses 6-1 

hexadecimal convert routine 8-9 

HIMEM 5-1, 5-2, 5-5, 5-7, 7-3, 8-12, 8-13, 8-17, 8-42 

I/O Block - see IOB 

I/O ERROR 4-16, 4-17, 6-8, A-16 

IN# command 8-3, 8-4, 8-9, 8-19 

INIT command 5-2, 6-8, 6-12, 8-4, 8-14, 8-19, 8-21, 8-26, 8-32, 

8-34, 8-40 
INIT, INITialization 3-1, 3-10, 3-12, 4-2, 5-1, 5-5, 5-7, 7-1, 

7-3, 8-40 
INPUT statement handler 8-6 
INT command 8-4, 8-14 
integer file 4-6, 4-12, 4-15, 6-10 
IOB 6-4 to 6-6, 8-38, 8-42, C-3 , C-8 

keyboard intercept handler 8-3, 8-5 

keyword flag bit 8-19 

keyword values table 8-8 

KSWL 8-6, 8-7, 8-20, 8-42, C-8 

language card 2-3, 7-2, 7-3, 8-41 

LOAD command 2-2, 4-12, 8-3, 8-4, 8-12, 8-19, 8-20 

LOCK command 5-2, 6-8, 6-11, 8-4, 8-10, 8-19, 8-24, 8-32 

L0MEM 8-12, 8-13, 8-42, C-9 

MASTER CREATE 2-2, 4-17, 7-1, 7-2 

master diskette 2-3, 5-6, 5-7, 7-1, 8-1, C-9 

MAXFILES command 5-2, 5-5, 6-13, 8-4, 8-5, 8-8, 8-9, 

8-17 to 8-21, C-6 
M0N command 2-1, 8-4, 8-7 to 8-9, 8-19, 8-20, 8-21 
motor on/Off 6-2, 6-3, 6-5, 8-38, 8-39 
MUFFIN 2-3 

nibbilize 2-3, 5-7, 8-2, 8-36, A-4, C-13 

nibble copy programs B-4 

N0M0N command 2-1, 8-4 to 8-6, 8-9, 8-19 

ONERR 8-13 

OPEN command 2-1, 2-2, 5-2, 6-8, 6-10 to 6-12, 8-4, 8-10, 

8-19, 8-22, 8-33 
open file 5-2, 6-7, 6-8, 6-10 6-13, 6-15, 8-10, 8-11, 8-14, 

8-2, 8-41 
output handler 8-6, 8-7 
overhead 4-1, 4-2 

parameter list, file manager 6-7 to 6-10, 6-12, 8-3, 
8-9 to 8-15, 8-26 to 8-35, A-5 , A-20, C-ll 

parmlist - see parameter list, file manager 

parse 8-7, C-ll 

Pascal 7-2 

phases - see disk arm phases 

POSITION command 2-1, 5-2, 6-8, 6-10, 6-12, 8-4, 8-14, 8-15, 
8-19, 8-25 

PR# command 8-3, 8-4, 8-9, 8-19 

prenibbilize 3-15, 3-20, 8-35, 8-38, A-l, A-4 

prologue 3-7, 3-12, 3-13, C-ll 

protected disk A-4, B-2 to B-4, C-12 

protection scheme - see protected disks 
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R type file - see RELOCATABLE file 
random file 4-10 ^r 

RDADR, read address field 8-36 Jg 

READ command 2-1, 5-2, 6-5, 6-6, 6-8, 6-10, 6-11, 6-12, 8-4, 

8-14, 8-19, 8-23 
read flag 8-6, 8-14 

RELOCATABLE files 2-2, 4-6, 4-12, 6-10 

RENAME Command 5-2, 6-8, 6-11, 8-4, 8-10, 8-19, 8-23 
repairing diskettes 4-16 to 4-18 
reserved bytes 3-12, 3-15, 3-21 
RESET 4-16, 4-18, 5-5, 8-5, B-3 

return code 6-5 to 6-8, 6-10 to 6-12 

RUN command 8-4, 8-6, 8-7, 8-13, 8-19, 8-21 

RWTS 2-2, 2-3, 3-15, 3-22, 4-17, 5-2, 5-3, 5-5, 5-7, 6-3, 6-4, 

6-6, 6-17, 7-2, 8-26 to 8-28, 8-34, 8-35, 8-38, 8-42, 

A-l, A-5, B-2, C-13 

S type files 2-2, 4-6, 4-12, 6-10 

SAVE command 2-3, 4-12, 8-4, 8-12, 8-19, 8-34 

sector interleaving 3-22, 3-23, 8-3, 8-39, C-8 

SEEK command 6-3, 6-5, 6-6 

self-sync bytes 3-4, 3-7, 3-8,. 3-10, 3-11, 8-37, 8-40, C-13 

sequential file 4-10, 4-11 

skewing - see sector interleaving 

slave diskette 5-6, 5-7, 7-1, 7-3 

slot number 6-2, 6-5 to 6-7, 6-10 to 6-12, 6-15, 8-1, 8-3, 8-4, 

8-28, 8-33, 8-35 to 8-38 
soft errors 4-16 
soft sectoring 3-2 
stepper motor 3-2, 6-2, 8-37 

T/L list - see track/sector list 

TEXT file 2-1, 4-6t 4-7, 4-10, 4-11, 4-17, 6-10, A-2 

toolkit, DOS 2-2, 4-12, A-2 

track/ sector list 4-8 to 4-10, 4-17, 4-18, 6-8, 6-10 to 6-13, 

6-15, 8-17, 8-22, 8-23, 8-25, 8-27 to 8-29, 8-32, 8-33, 

A-2, A-16, C-6, C-15 
translate table 8-37, C-15 

UNLOCK command 5-2, 6-8, 6-11, 8-4, 8-10, 8-19, 8-24, 8-32 
utility programs, A-l to A-26 

COPY, convert files A-2, A-20 to A-26 

DUMP, track dump facility A-l, A-4 to A-7 

FTS, find T/S list A.-2, A-16 to A-20 

INIT, reformat single track A-2, A-12 to A-15 

ZAP, disk update utility A-l, A-8 to A-ll 

vectors, DOS 5-2, 5-4, 5-5, 6-17 

VERIFY command 2-3, 4-17, 5-2, 6-8, 6-1, 8-4, 8-12, 8-19, 8-25, 

8-34 
video intercept handler 8-3, 8-5 
video intercept state 8-6, 8-8 
VTOC, volume table of contents 2-3, 3-2, 4-2 to 4-5, 4-18, 5-5, 

6-7, 8-23, 8-25, 8-26, 8-28, 8-30 to 8-33, C-15 

warmstart 5-5, 8-5, 8-8, 8-15, 8-20, C^15 

WRITE command 2-1, 5-2, 6-5, 6-6, 6-8, 6-10 to 6-12, 8-4, 8-7, 
8-13, 8-14, 8-19, 8-23 

ZAP 4-17, 4-18, 8-42, A-l, A-16, C-16 
zero page, DOS usage 8-42 
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FILE MANAGER RETURN CODES (+0A) 



DOS PAGE 3 VECTORS 



• 01) 



00 = NO ERRORS 

01 = NOT USED 

02 = BAD CALL TYPE (+00) 

03 = BAD SUB-CALL TYPE ( 

04 = WRITE PROTECTED 

05 = END OF DATA 

06 = FILE NOT FOUND (WAS ALLOCATED IF X=0 WHEN CALLED) 

07 = VOLUME MISMATCH 

08 = DISK I/O ERROR 

09 = DISK FULL 
0A = FILE LOCKED 

Also See Page 6-8 



DOS FILE BUFFER FORMAT 



FILENAME 
FMW 



TSL 
DATA 



IF FIRST BYTE IS 00 THIS FILE BUFFER IS FREE 
ADDRESS OF FILE MANAGER WORKAREA 
BUFFER (45 BYTES) 

ADDRESS OF T/S LIST BUFFER (256 BYTES) 
ADDRESS OF DATA SECTOR (256 BYTES) 

Also See Page 6-13 



DOS ADDRESSES FOR VARIOUS 
MACHINE SIZES 





MAIN 


FILE 




END 


SIZE 


DOS 


MANG. 


RWTS 


RAM 


16K 


1D00 


2AFD 


37 B5 


4000 


20K 


2D00 


3AFD 


47 B5 


5000 


24 K 


3D00 


4AFD 


57 B5 


6000 


32 K 


5D00 


6AFD 


77 B5 


8000 


36 K 


6D00 


7AFD 


87 B5 


9000 


40 K 


7D00 


8AFD 


97 B5 


A000 


48K 


9D00 


AAFD 


B7B5 


cooo 



Also See Page 5-3 



3 DO 


JMP 


$9DBF 


JUMP TO DOS WARMSTART 


3D3 


JMP 


S9D84 


JUMP TO DOS COLDSTART 


3D6 


JMP 


SAAFD 


JUMP TO DOS FILE MANAGER 


3D9 


JMP 


$B7B5 


JUMP TO RWTS 


3DC 


LDA 


S9D0F 


SUBROUTINE TO LOCATE FILE 




LDY 


S9D0E 


MANAGER PARM LIST 




RTS 






3E3 


LDA 


SAAC2 


SUBROUTINE TO LOCATE RWTS 




LDY 


SAAC1 


PARM LIST 




RTS 






3EA 


JMP 


SA851 


JUMP TO REPLACE DOS INTERCEPTS 




NOP 




SUBROUTINE 




NOP 






3EF 


JMP 


$FA59 


AUTOSTART BRK HANDLER 


3F2 


$9DBF 




AUTOSTART RESET HANDLER 


3F4 


$38 




POWER-UP BYTE ($3F3 EOR $A5) 


3F5 


JMP 


$FF58 


APPLESOFT & HANDLER 


3F8 


JMP 


SFF65 


CTL-Y HANDLER 


3FB 


JMP 


$FF65 


NMI HANDLER 


3FE 


SFF65 




IRQ HANDLER 



Also See Page 5-5 



DOS LOCATION TABLE 



Beneath 
Apple 



i ik 





DISKETTE STORAGE 




MEMORY STORAGE 


MASTER 


SLAVE 


LOAD 


RELOCATED 


TRACK 


SECTOR 


TRACK 


SECTOR 


ADDRESS 


ADDRESS 


00 


00 


00 


00 


$3600 


$B600 


no 


01 


no 


01 


$3700 


$B700 


00 


0? 


nn 


02 


$3800 


$B800 


00 


03 


00 


03 


$3900 


$B900 


00 


04 


00 


04 


$3A00 


$BA00 


00 


05 


00 


05 


$3 BOO 


$BB00 


00 


06 


00 


06 


S3C00 


$BC00 


on 


07 


on 


07 


$3D00 


$BD00 


00 


08 


00 


08 


$3E00 


SBE00 


on 


09 


00 


09 


$3F00 


$BF00 


00 


0A 


00 


04* 


$1B00 




00 


0B 


00 


0B* 


$1C00 




00 


OC 


00 


OC 


$1D00 


$9D00 


on 


no 


00 


0D 


S1E00 


$9E00 


00 


nE 


00 


0E 


$1F00 


$9F00 


00 


OF 


00 


OF 


$2000 


$A000 


01 


00 


01 


00 


$2100 


$A100 


01 


01 


01 


01 


$2200 


SA200 


01 


02 


01 


02 


$2300 


$A300 


01 


03 


01 


03 


$2400 


$A400 


0! 


nJ 


01 


oj 


$2500 


SA500 


01 


05 


0! 


05 


$2600 


$A600 


(11 


06 


01 


06 


$2700 


$A700 


01 


nr ' 


01 


67 


$2800 


$A800 


m 


06 


01 


na 


$2900 


$A900 


01 


no 


01 


no 


$2A00 


$AA00 


01 


OA 


01 


nA 


$2 BOO 


$AB00 


m 


nrj 


01 


[IB 


$2C00 


$AC00 


01 


nc 


01 


OC 


$2D00 


$AD00 


01 


no 


01 


0D 


$2E00 


SAE00 


01 


0E 


01 


OE 


$2F00 


$AF00 


01 


OF 


01 


nF 


$3000 


$B000 


0? 


00 


02 


00 


S3100 


$B100 


02 


01 


02 


01 


$3200 


SB200 


02 


02 


02 


02 


$3300 


$B300 


02 


03 


02 


03 


$3400 


$B400 


0? 


04 


02 


04 


$3500 


$B500 


'These sectors are blar 


k 












Also See Page 


5-6 





REFERENCE 
CARD 



DOS 3.3 



QUTILny SOFTW7IR6 

6660 Reseda Blvd. 
Suite 105 

Reseda, CA 91335 
(213) 344-6599 



RWTS CALL 

JSR $3E3 LOCATE PARM LIST. 

STY PTR SET UP ZPAGE . 

STA PTR+1 POINTER. 



JSR $3E3 RELOAD PARM PTR. 

JSR $3D9 CALL RWTS 

BCS ERROR IF ERROR, BRANCH 



Also See Page 6-4 



RWTS PARAMETERS (IOB) 



FILE MANAGER CALL 

JSR $3DC LOCATE PARM LIST. 

STY PTR SET UP ZPAGE . . . 

STA PTR+1 POINTER. 



LDX #0 ALLOW NEW FILE 

JSR $3D6 CALL FILE MANAGER 

BCS ERROR IF ERROR, BRANCH 

Also See Page 6-7 



FILE MANAGER PARAMETER LIST 



$01 


SLOT 
16 


DRIVE 


VOL 


TRK 


SEC 


ADDR OF 
DCT 


ADDR OF 
BUFFER 


NOT 
USED 


$00 


CC 


RC 


PREV. 
VOL 


PREV. 
SLOT 


PREV 
DRIVE 




CC: COMM/ 
$00 = S 


iND CODE 
EEK 



RC: RETURN CODE 

$00 = NO ERRORS 

$08 = FORMATTING ERROR 

$10 = WRITE PROTECTED 



$01 = READ 
$02 = WRITE 
$04 = FORMAT 



$20 = VOL MISMATCH 
$40 = DRIVE ERROR 
$80 = READ ERROR 



Also See Page 6-5 



DEVICE CHARACTERISTICS TABLE 
(DCT) 



TYPE 
$00 


PHASES 
$01 


MOTOR ON 
$EFD8 



Also See Page 6-5 
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FILE MANAGER RETURN CODES (+0A) 

00 = NO ERRORS 

01 = NOT USED 

02 = BAD CALL TYPE (+00) 

03 = BAD SUB-CALL TYPE (+01) 

04 = WRITE PROTECTED 

05 = END OF DATA 

06 = FILE NOT FOUND (WAS ALLOCATED IF X=0 WHEN CALLED) 

07 = VOLUME MISMATCH 

08 = DISK I/O ERROR 

09 = DISK FULL 
0A = FILE LOCKED 



Also See Page 6-8 



DOS FILE BUFFER FORMAT 



00 
08 
10 


FILE NAME 




18 


FMW 


20 


TSL 


DATA | LINK 





FILENAME 
FMW 



TSL 
DATA 



IF FIRST BYTE IS 00 THIS FILE BUFFER IS FREE 
ADDRESS OF FILE MANAGER WORKAREA 
BUFFER (45 BYTES) 

ADDRESS OF T/S LIST BUFFER (256 BYTES) 
ADDRESS OF DATA SECTOR (256 BYTES) 

Also See Page 6-13 



DOS ADDRESSES FOR VARIOUS 
MACHINE SIZES 





MAIN 


FILE 




END 


SIZE 


DOS 


MANG. 


RWTS 


RAM 


16K 


1D00 


2AFD 


37 B5 


4000 


20K 


2D00 


3AFD 


47 B5 


5000 


24K 


3D00 


4AFD 


57 B5 


6000 


32K 


5D00 


6AFD 


77 B5 


8000 


36 K 


6DO0 


7AFD 


87B5 


9000 


40 K 


7D00 


8AFD 


97B5 


A000 


48 K 


9D00 


AAFD 


B7B5 


cooo 



Also See Page 5-3 



TRACK FORMAT 



ADDRESS FIELD 



SECTOR CHECKSUM 



DIRECT USE OF DISK DRIVE 



D5 AA 96 XX YY XX YY XX YY XX YY DE AA EB 



ODD-EVEN ENCODED 

DATA BYTE— DrD6DsD4D3D2DiDo 
XX — 1 D? 1 Ds 1 D 3 1 Di 
YY — 1 De 1 D4 1 D2 1 Do 

Also See Page 3-12 



DATA FIELD 



D5 AA AD 342 BYTES DATA 



XX DE AA EB 



SIX AND TWO 
ENCODED 

Also See Page 3-13 



"6 and 2" WRITE TRANSLATE TABLE 



00 = 96 

01 = 97 

02 = 9A 

03 = 9B 

04 = 9D 

05 = 9E 

06 = 9F 

07 = A6 

08 = A7 

09 = AB 
0A = AC 
0B = AD 
0C = AE 
OD = AF 
OE = B2 
OF = B3 



10 = B4 

11 = B5 

12 = B6 

13 = B7 

14 = B9 

15 = BA 

16 = BB 

17 = BC 

18 = BD 

19 = BE 
1A = BF 
1B = CB 
1C = CD 
1D = CE 
1E = CF 
1F = D3 



20 = D6 

21 = D7 

22 = D9 

23 = DA 

24 = DB 

25 = DC 

26 = DD 

27 = DE 

28 = DF 

29 = E5 
2A = E6 
2B = E7 
2C = E9 
2D = EA 
2E = EB 
2F = EC 



30 = ED 

31 = EE 

32 = EF 

33 = F2 

34 = F3 

35 = F4 

36 = F5 

37 = F6 

38 = F7 

39 = F9 
3A = FA 
3B = FB 
3C = FC 
3D = FD 
3E = FE 
3F = FF 



__ i Reserved Bytes 



ADDRESS LABEL 




DESCRIPTION 




$C080 


PHASEOFF 




Stepper motor phase 


off. 


?C081 


PHASEON 




Stepper motor phase 


on. 


$C082 


PHASE 10FF 




Stepper motor phase 


1 off. 


SC083 


PHASE ION 




Stepper motor phase 


1 on. 


SC084 


PHASE20FF 




Stepper motor phase 


2 off. 


$C085 


PHASE20N 




Stepper motor phase 


2 on. 


$C086 


PHASE30FF 




Stepper motor phase 


3 off. 


$C087 


PHASE 30N 




Stepper motor phase 


3 on. 


$C088 


MOTOROFF 




Turn motor off. 




$C089 


MOTORON 




Turn motor on. 




$C08A 


DRVOEN 




Engage drive 1. 




$C08B 


DRV1EN 




Engage drive 2. 




$C08C 


Q6L 




Strobe Data Latch for I/O. 


$C08D 


Q6H 




Load Data Latch. 




5C08E 


Q7L 




Prepare latch for input. 


$C08F 


Q7H 




Prepare latch for output. 




Q7L with 


Q6L = Read 






Q7L w 


th 


Q6H = Sense Write Protect 






07H w 


th 


06L = Write 






Q7H w 


th 


Q6H = Load Write Latch 






Also See Pages 6-1 to 6-3 





Also See Page 3-20 



DISK LAYOUT 

TRACKS 

All DOS versions 35 

SECTORS PER TRACK 

DOS 3.2.1 and earlier 13 

DOS 3.3 16 

SECTORS PER DISKETTE 

DOS 3.2.1 and earlier 455 

DOS 3.3 560 

BYTES PER SECTOR 

All DOS versions 256 

BYTES PER DISKETTE 

DOS 3.2.1 and earlier 116480 

DOS 3.3 143360 

USABLE* SECTORS FOR DATA STORAGE 

DOS 3.2.1 and earlier 403 

DOS 3.3 496 

USABLE* BYTES PER DISKETTE 

DOS 3.2.1 and earlier 103168 

DOS 3.3 126976 

* Excludes DOS, VTOC, and CATALOG 



VOLUME TABLE OF CONTENTS (VTOC) 

TRACK $11, SECTOR $00 





I ' I 


| 


00 


| LINK | VER 


1 v 1 


08 




10 




18 




20 


| NE 


28 




30 


AT U-| 


TD | ST | SS 


38 


TRACK 


TRACK 1 


40 


2 


3 


48 


4 


5 


50 


6 


7 


58 


8 


9 


60 


10 


11 


68 


12 


13 


70 


14 


15 


78 


16 


17 


80 


18 


19 


88 


20 


21 


90 


22 


23 


98 


24 


25 


A0 


26 


27 


A8 


28 


29 


B0 


30 


31 


B8 


32 


33 


CO 


34 




C8 




DO 




D8 




E0 




E8 




F0 




F8 





LINK 
VER 
V 

NE 
AT 
+ - 
TD 
ST 
SS 
TRACK 



TRACK N 



T/S OF FIRST DIRECTORY SECTOR 

DOS VERSION (1, 2, OR 3) 

VOLUME NUMBER (1-254) 

NUMBER OF T/S LIST ENTRIES PER T/S LIST SECTOR 

LAST TRACK ALLOCATED 

DIRECTION OF TRACK ALLOCATION 

NUMBER OF TRACKS PER DISK 

NUMBER OF SECTORS PER TRACK 

SECTOR SIZE IN BYTES 

FREE SECTORS BIT MAP FOR TRACK 



FREE SECTORS BIT MAP FOR TRACK N 



FREE SECTORS BIT MAP 

13 SECTOR DISK: CBA9 8765 4321 0... 
16 SECTOR DISK: FEDC BA98 7654 3210 



Also See Pages 4-2 to 4-4 



VOLUME TABLE OF CONTENTS (VTOC) 

TRACK $11, SECTOR $00 



DIRECTORY (CATALOG) SECTOR 





I ' I 


I'll 


00 


| LINK | VER 


Iv | 


08 




10 




18 




20 


| NE 


28 




30 


AT | + -| 


TD I ST | SS 


38 


TRACK 


TRACK 1 


40 


2 


3 


48 


4 


5 


50 


6 


7 


58 


8 


9 


60 


10 


11 


68 


12 


13 


70 


14 


15 


78 


16 


17 


80 


18 


19 


88 


20 


21 


90 


22 


23 


98 


24 


25 


A0 


26 


27 


A8 


28 


29 


B0 


30 


31 


B8 


32 


33 


CO 


34 




C8 




DO 




D8 




E0 




E8 




F0 




F8 





LINK 
VER 

V 

NE 

AT 

+ - 

TD 

ST 

SS 

TRACK 



T/S OF FIRST DIRECTORY SECTOR 

DOS VERSION (1, 2, OR 3) 

VOLUME NUMBER (1-254) 

NUMBER OF T/S LIST ENTRIES PER T/S LIST SECTOR 

LAST TRACK ALLOCATED 

DIRECTION OF TRACK ALLOCATION 

NUMBER OF TRACKS PER DISK 

NUMBER OF SECTORS PER TRACK 

SECTOR SIZE IN BYTES 

FREE SECTORS BIT MAP FOR TRACK 





1 


I I I I 


00 


LINK 




08 




TSP | FT | 


10 




18 


FILENAME #1 


20 






28 


I FL I 


30 




38 


ENTRY FOR FILE #2 


40 




48 




50 




58 




60 


ENTRY FOR FILE #3 


68 






70 


_| 


78 




80 


ENTRY FOR FILE #4 


88 




90 




98 




A0 


ENTRY FOR FILE »5 


AH 




R0 




B8 


I 




CO 






08 


ENTRY FOR FILE »6 


DO 






D8 


I 


to 




EH 


ENTRY FOR FILE «7 


F0 




F8 





TRACK N — FREE SECTORS BIT MAP FOR TRACK N 



FREE SECTORS BIT MAP 

13 SECTOR DISK: CBA9 8765 4321 0... 
16 SECTOR DISK: FEDC BA98 7654 3210 



Also See Pages 4-2 to 4-4 



LINK - T/S OF NEXT DIRECTORY SECTOR OR 0000 IF NO 

MORE EXIST 
TSP - T/S POINTER OF FIRST T/S LIST FOR THIS FILE OR 00 IF 

END OF DIRECTORY OR FF IF DELETED FILE. 
FT - FILE TYPE: 80-LOCKED 00-TEXT 

01-INT BASIC 02-ASOFT 04-BINARY 

08-S 10-R 20-A 

40-B 
FL - FILE LENGTH IN SECTORS 

REMAINING FILE ENTRIES HAVE SAME FORMAT AS FOR 
FILE #1 (TSP THROUGH FL) 



Also See Page 4-6 



TRACK/SECTOR LIST SECTOR 





I 


I 


I 




00 


LINK 


I OFF 


08 




SO 


S1 


10 


S2 


S3 


S4 


S5 


18 


S6 


S7 


S8 


S9 


20 


S10 


S11 


S12 


S13 


28 


S14 


S15 


S16 


S17 


30 


S18 


S19 


S20 


S21 


38 


S22 


S23 


S24 


S25 


40 


S26 


S27 


S28 


S29 



S106 


S107 




S109 


S110 


S111 


S112 


S113 


S114 


S115 


S116 


S117 


S118 


S119 


S120 


S121 



LINK 
OFF 
SO 
S1 



T/S OF NEXT T/S LIST SECTOR IF DATA SECTORS 

EXIST BEYOND 121. 

SECTOR OFFSET INTO FILE OF FIRST DATA SECTOR 

LISTED 

T/S OF DATA SECTOR OR 0000 IF THIS SECTOR 

WAS NOT WRITTEN 

etc. 

Also See Page 4-8 



TEXT FILE FORMAT 



[ 



RECORD 



L 



RECORD 1 



l~8P] fool 



8D = CARRIAGE RETURN 00 = END OF DATA 

Also See Page 4-11 

BASIC (A OR I) FILE FORMAT 

QD CUD CZ 



PROGRAM IMAGE 



LL = LENGTH OF IMAGE LOW ORDER PART 
LH = LENGTH OF IMAGE HIGH ORDER PART 

Also See Pages 4-14. 4-15 



BINARY FILE FORMAT 



ZD i ah i i ll i i lh i [ 



BINARY IMAGE 



AL = ADDRESS OF IMAGE LOW ORDER PART 
AH = ADDRESS OF IMAGE HIGH ORDER PART 
LL = LENGTH OF IMAGE LOW ORDER PART 
LH = LENGTH OF IMAGE HIGH ORDER PART 

Also See Page 4-13 



rSTB QUTiLny 
Beneath Apple DOS ££] somvaRe 



- —*mr*tr 
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